Como listar todos os grupos aos quais um usuário pertence com o PowerShell

No cenário em rápida evolução da TI, o gerenciamento eficaz de usuários e a compreensão das funções dos usuários continuam sendo essenciais para a segurança e a eficiência de qualquer organização. Entre as ferramentas disponíveis para os profissionais de TI, os scripts do PowerShell se destacam como soluções poderosas para automatizar tarefas. Um desses scripts se concentra em listar todos os grupos aos quais um usuário pertence.

Histórico

As associações a grupos de usuários definem os direitos e as permissões que um usuário tem em uma rede. À medida que uma organização cresce, manter o controle dessas associações torna-se cada vez mais importante. No entanto, isso pode ser complicado e propenso a erros se for feito manualmente. É aqui que nosso script do PowerShell se destaca. Especificamente projetado para listar todos os grupos dos quais um usuário é membro, esse script é inestimável para profissionais de TI e provedores de serviços gerenciados (MSPs). Garantir a associação correta aos grupos ajuda a evitar a alocação excessiva de privilégios e sustenta a postura de segurança de uma organização.

O roteiro

#Requires -Version 4.0 -RunAsAdministrator

<#
.SYNOPSIS
    This will output the groups that the specified user belongs to.
.DESCRIPTION
    This will output the groups that the specified user belongs to.
.EXAMPLE
     -UserName "Administrator" -IsDomainUser
    Will get the groups that the user Administrator belongs to in Active Directory.
.EXAMPLE
     -UserName "Administrator"
    Will get the groups that the user Administrator belongs to on the machine it runs on.
.EXAMPLE
    PS C:> Get-User-Membership.ps1 -UserName "Administrator"
    Will get the groups that the user Administrator belongs to on the machine it runs on.
.OUTPUTS
    Output (PSCustomObject)
.NOTES
    Minimum OS Architecture Supported: Windows 10, Windows Server 2012
    If you wish to interact with AD you will need to install RSAT with at least the AD feature.
    Release Notes:
    Initial Release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. 
    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. 
    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. 
    Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. 
    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. 
    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. 
    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
.COMPONENT
    ManageUsers
#>

[CmdletBinding()]
param (
    # Specify one user
    [Parameter(Mandatory = $false)]
    [String]
    $UserName,
    # Modify Local User Membership
    [Parameter(Mandatory = $false)]
    [Switch]
    $IsDomainUser
)

begin {}

process {
    if (-not $IsDomainUser) {
        # Get local machine groups
        Get-LocalGroup | ForEach-Object {
            $Group = $_.Name
            # Get users in current group
            # Check that $UserName is a member of this current group and output it to StdOut/Write-Output
            Get-LocalGroupMember -Group $Group | Where-Object { $_.Name -like "*$UserName" } | ForEach-Object {
                [PSCustomObject]@{
                    Group = $Group
                    User  = $_.Name
                }
            }
        }
    }
    else {
        if ((Get-Module -Name ActiveDirectory -ListAvailable -ErrorAction SilentlyContinue)) {
            try {
                Import-Module -Name ActiveDirectory
                # Get most of our data needed for the logic, and to reduce the number of time we need to talk to AD
                $ADUser = (Get-ADUser -Identity $UserName -Properties SamAccountName -ErrorAction SilentlyContinue).SamAccountName
            }
            catch {
                Write-Error -Message "Ninja Agent could not access AD, either RSAT was not installed or that the agent does not have permissions to view users and groups."
                exit 5 # Access Denied exit code
            }
            # Get a list of groups that the user is in
            # Loop through each group
            Get-ADGroup -Filter * -ErrorAction SilentlyContinue | ForEach-Object {
                $ADGroup = $_
                # Get users from current group and filter out all other users
                Get-ADGroupMember -Identity $ADGroup -ErrorAction SilentlyContinue | Where-Object {
                    $_.SamAccountName -like $ADUser
                } | ForEach-Object {
                    # Write out to StandardOutput
                    [PSCustomObject]@{
                        Group = $ADGroup.Name
                        User  = $_.SamAccountName
                    }
                }
            }
        }
        else {
            # Throw error that RSAT: ActiveDirectory isn't installed
            Write-Error -Message "RSAT: ActiveDirectory is not installed or not found on this computer. The PowerShell Module called ActiveDirectory is needed to proceed." -RecommendedAction "https://docs.microsoft.com/en-us/powershell/module/activedirectory/"
            exit 2 # File Not Found exit code
        }
    }
}
end {}

Detalhamento

O script pode ser dividido em dois componentes principais com base em sua função:

• Verificação da associação ao grupo local: Se a opção -IsDomainUser não for especificada, o script buscará e listará os grupos dos quais o usuário especificado é membro no computador local.
• Verificação de associação a grupos do Active Directory: Se a opção -IsDomainUser for definida, o script se comunicará com o Active Directory para buscar e listar os grupos dos quais o usuário especificado faz parte.

Durante todo o processo, o script gera os resultados como um PSCustomObject, garantindo que os dados sejam estruturados e possam ser facilmente compreendidos ou processados posteriormente.

Caso de uso potencial

Imagine um profissional de TI em uma grande empresa que precisa verificar as associações de grupo de um novo chefe de departamento. Usando o script, o profissional de TI pode listar facilmente todos os grupos dos quais o usuário é membro, tanto em ambientes locais quanto no Active Directory. Isso garante que o chefe de departamento tenha as permissões corretas, evitando possíveis violações de segurança ou erros de acesso.

Abordagem alternativa

Embora a interface gráfica do Active Directory Users and Computers (ADUC) permita a visualização das associações de grupos, ela é manual e não é adequada para verificações em massa. Nosso script do PowerShell automatiza essa tarefa, tornando-a eficiente para a verificação de vários usuários ou auditorias frequentes. Além disso, com o PowerShell, os resultados podem ser facilmente exportados, filtrados ou integrados a relatórios, oferecendo a flexibilidade que falta às ferramentas de GUI.

Implicações

A associação incorreta a grupos pode levar ao acesso não autorizado a dados ou à negação de recursos essenciais aos usuários. Ao determinar com precisão as associações de usuários usando nosso script do PowerShell, os profissionais de TI podem aumentar a segurança e garantir a conformidade regulamentar.

Recomendações

• Sempre execute o script em um ambiente seguro e controlado primeiro.
• Audite regularmente as associações de grupos de usuários, especialmente para funções de alto privilégio.
• Integrar os resultados do script em uma estratégia mais ampla de IAM (Identity and Access Management).

Considerações finais

A NinjaOne, com seu conjunto abrangente de soluções de TI, pode ser um parceiro inestimável na automação, gerenciamento e proteção de ambientes de TI. Quando scripts como o discutido acima são combinados com os recursos do NinjaOne, os profissionais de TI podem aumentar sua eficiência, precisão e postura de segurança. Essa sinergia abre caminho para uma abordagem proativa do gerenciamento e da segurança de TI.