Add-EntraGroupMember

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

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

Sintaxe

Default (Default) 

Add-EntraGroupMember

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

Description

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

New-EntraGroupMember e Add-EntraGroupMembership são aliases de Add-EntraGroupMember.

Em cenários delegados, o usuário conectado precisa de uma função de Microsoft Entra com suporte ou uma função personalizada com a microsoft.directory/groups/members/update permissão. As funções mínimas necessárias para esta operação, excluindo grupos atribuíveis a função, são:

  • Proprietários do grupo
  • Gravadores de diretório
  • 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 exclusivo (ID do objeto) do grupo ao qual você deseja adicionar um membro.
  • -MemberId - Especifica o identificador exclusivo (ID do objeto) do membro a ser adicionado ao grupo. Você pode adicionar usuários, grupos de segurança, grupos de Microsoft 365, dispositivos, entidades de serviço e contatos organizacionais a grupos de segurança. Somente os usuários podem ser adicionados a grupos de Microsoft 365.

Exemplo 2: Adicionar membros com base nos resultados da 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 em um resultado de pesquisa a um grupo.

  • -GroupId - Especifica o identificador exclusivo (ID do objeto) do grupo ao qual você deseja adicionar um membro.

Exemplo 3: sincronizar usuários 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 do grupo de destino de origem para um novo grupo.

  • -GroupId - Especifica o identificador exclusivo (ID do objeto) do grupo ao qual você deseja adicionar um membro.

Parâmetros

-GroupId

Especifica a ID de um grupo em Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-MemberId

Especifica o identificador exclusivo (ID do objeto) do membro a ser adicionado ao grupo. Você pode adicionar usuários, grupos de segurança, grupos de Microsoft 365, dispositivos, entidades de serviço e contatos organizacionais a grupos de segurança. Somente os usuários podem ser adicionados a grupos de Microsoft 365.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:RefObjectId

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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.