Get-AzureRmADGroup

Filtra grupos do Ative Directory.

Aviso

O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Syntax

Get-AzureRmADGroup
   [-ObjectId <Guid>]
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADGroup
   -DisplayNameStartsWith <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADGroup
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]
Get-AzureRmADGroup
   -ObjectId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-IncludeTotalCount]
   [-Skip <UInt64>]
   [-First <UInt64>]
   [<CommonParameters>]

Description

Filtra grupos do Ative Directory.

Exemplos

Exemplo 1 - Listar todos os grupos do AD

PS C:\> Get-AzureRmADGroup

Lista todos os grupos do AD em um locatário.

Exemplo 2 - Listar todos os grupos do AD usando paginação

PS C:\> Get-AzureRmADGroup -First 100

Lista os primeiros 100 grupos do AD em um locatário.

Exemplo 3 - Obter grupo do AD por id de objeto

PS C:\> Get-AzureRmADGroup -ObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE

Obtém um grupo do AD com a id do objeto '85F89C90-780E-4AA6-9F4F-6F268D322EEE'.

Exemplo 4 - Listar grupos por cadeia de pesquisa

PS C:\> Get-AzureRmADGroup -SearchString Joe

Lista todos os grupos do AD cujo nome para exibição começa com 'Joe'.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

O nome a apresentar do grupo.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisplayNameStartsWith

Usado para localizar grupos que começam com a cadeia de caracteres fornecida.

Type:String
Aliases:SearchString
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-First

O número máximo de objetos a serem retornados.

Type:UInt64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeTotalCount

Relata o número de objetos no conjunto de dados. Atualmente, este parâmetro não faz nada.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

ID do objeto do grupo.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Skip

Ignora os primeiros objetos N e, em seguida, obtém os objetos restantes.

Type:UInt64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Guid

Saídas

PSADGroup