Compartilhar via


Add-AzureRmADGroupMember

Adiciona um usuário a um grupo existente do AD.

Aviso

O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupObjectId <Guid>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupDisplayName <String>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberObjectId <Guid[]>
   -TargetGroupObject <PSADGroup>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupDisplayName <String>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupObject <PSADGroup>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-AzureRmADGroupMember
   -MemberUserPrincipalName <String[]>
   -TargetGroupObjectId <Guid>
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Adiciona um usuário a um grupo existente do AD.

Exemplos

Exemplo 1 – Adicionar um usuário a um grupo por ID de objeto

PS C:\> Add-AzureRmADGroupMember -MemberObjectId D9076BBC-D62C-4105-9C78-A7F5BC4A3405 -TargetGroupObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE

Adiciona o usuário com a ID de objeto 'D9076BBC-D62C-4105-9C78-A7F5BC4A3405' ao grupo com a ID de objeto '85F89C90-780E-4AA6-9F4F-6F268D322EEE'.

Exemplo 2 - Adicionar um usuário a um grupo por canalização

PS C:\> Get-AzureRmADGroup -ObjectId 85F89C90-780E-4AA6-9F4F-6F268D322EEE | Add-AzureRmADGroupMember -MemberObjectId D9076BBC-D62C-4105-9C78-A7F5BC4A3405

Obtém o grupo com a ID de objeto '85F89C90-780E-4AA6-9F4F-6F268D322EEE' e o canaliza para o cmdlet Add-AzureRmADGroupMember para adicionar o usuário a esse grupo.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MemberObjectId

A ID do objeto do membro.

Tipo:Guid[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MemberUserPrincipalName

O UPN dos membros a serem adicionados ao grupo.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Especificar isso retornará true se o comando tiver sido bem-sucedido.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TargetGroupDisplayName

O nome de exibição do grupo ao qual adicionar o(s) membro(s).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TargetGroupObject

A representação do objeto do grupo ao qual adicionar o(s) membro(s).

Tipo:PSADGroup
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TargetGroupObjectId

O ID do objeto do grupo ao qual adicionar o(s) membro(s).

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSADGroup

Parâmetros: TargetGroupObject (ByValue)

Saídas

Boolean