Add-EntraGroupMember

Módulo:
Microsoft.Entra.Groups Module v1.3

Adicione um membro a um grupo de segurança ou Microsoft 365.

Sintaxe

Default (Predefinição) 

Add-EntraGroupMember

    -GroupId <String>
    -MemberId <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrição

O Add-EntraGroupMember cmdlet adiciona um membro a um grupo de segurança ou Microsoft 365.

New-EntraGroupMember e Add-EntraGroupMembership são pseudónimos de Add-EntraGroupMember.

Em cenários delegados, o utilizador iniciado necessita de um papel Microsoft Entra suportado ou de um papel personalizado com essa microsoft.directory/groups/members/update permissão. Os papéis mínimos exigidos para esta operação, excluindo grupos atribuídos a papéis, são:

  • Proprietários de grupos
  • Escritores de Diretórios
  • Administrador de Grupos
  • Administrador de usuários

Exemplos

Exemplo 1: Adicionar um membro a um grupo

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Contoso Marketing Group'"
$user = Get-EntraUser -UserId 'SawyerM@contoso.com'
Add-EntraGroupMember -GroupId $group.Id -MemberId $user.Id

Este exemplo demonstra como adicionar um membro a um grupo.

  • -GroupId - Especifica o identificador único (ID do Objeto) do grupo ao qual pretende adicionar um membro.
  • -MemberId - Especifica o identificador único (ID do objeto) do membro a ser adicionado ao grupo. Pode adicionar utilizadores, grupos de segurança, grupos do Microsoft 365, dispositivos, principais de serviço e contactos organizacionais aos grupos de segurança. Apenas os utilizadores podem ser adicionados aos grupos da Microsoft 365.

Exemplo 2: Adicionar membros com base nos resultados de pesquisa a um grupo

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraUser -Filter "startsWith(displayName,'Updated User')" |
    Add-EntraGroupMember -GroupId $group.Id

Este exemplo demonstra como adicionar membros com base num resultado de pesquisa a um grupo.

  • -GroupId - Especifica o identificador único (ID do Objeto) do grupo ao qual pretende adicionar um membro.

Exemplo 3: Sincronizar utilizadores de um grupo para outro

Connect-Entra -Scopes 'GroupMember.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Sales and Marketing'"
Get-EntraGroupMember -GroupId "source-group-id" |
    Add-EntraGroupMember -GroupId $group.Id

Este exemplo demonstra como sincronizar membros do grupo de origem do grupo-alvo para um novo grupo.

  • -GroupId - Especifica o identificador único (ID do Objeto) do grupo ao qual pretende adicionar um membro.

Parâmetros

-GroupId

Especifica o ID de um grupo no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-MemberId

Especifica o identificador único (ID do objeto) do membro a ser adicionado ao grupo. Pode adicionar utilizadores, grupos de segurança, grupos do Microsoft 365, dispositivos, principais de serviço e contactos organizacionais aos grupos de segurança. Apenas os utilizadores podem ser adicionados aos grupos da Microsoft 365.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:RefObjectId

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.