Compartilhar via

Add-UnifiedGroupLinks

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online, Exchange Online Protection

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Add-UnifiedGroupLinks para adicionar membros, proprietários e assinantes a Grupos do Microsoft 365 em sua organização baseada em nuvem. Para remover membros, proprietários e assinantes, use o cmdlet Remove-UnifiedGroupLinks. Para modificar outras propriedades de Grupos do Microsoft 365, use o cmdlet Set-UnifiedGroup.

Observação: você não pode usar esse cmdlet para modificar membros, proprietários ou assinantes do Grupo microsoft 365 se você se conectar usando autenticação baseada em certificado (também conhecida como CBA ou autenticação somente aplicativo para scripts autônomos) ou identidade gerenciada do Azure. Em vez disso, você pode usar o Microsoft Graph. Para obter mais informações, consulte Tipo de recurso de grupo.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Add-UnifiedGroupLinks
   [-Identity] <UnifiedGroupIdParameter>
   -Links <RecipientIdParameter[]>
   -LinkType <LinkType>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Grupos do Microsoft 365 são objetos de grupo disponíveis nos serviços do Microsoft 365.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Observação: somente os membros podem ser proprietários de um grupo, portanto, primeiro você deve adicionar um usuário como membro antes de adicioná-lo como proprietário. Os usuários convidados não podem ser proprietários de grupos, mesmo que os usuários sejam membros dos grupos.

Exemplos

Exemplo 1

Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com

Este exemplo adiciona membros chris@contoso.com e michelle@contoso.com ao Grupo do Microsoft 365 chamado Departamento Jurídico.

Exemplo 2

$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}

Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)

Este exemplo mostra como adicionar membros em massa a um Grupo do Microsoft 365. Caixas de correio em que o atributo do Departamento é "Marketing" são adicionadas ao Grupo do Microsoft 365 chamado Marketing.

Parâmetros

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identity especifica o Grupo microsoft 365 que você deseja modificar. Você pode usar qualquer valor que identifique exclusivamente o Grupo do Microsoft 365. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID
Type:UnifiedGroupIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Links

O parâmetro Links especifica os destinatários a serem adicionados ao Grupo do Microsoft 365. Você especifica se esses destinatários são membros, proprietários ou assinantes usando o parâmetro LinkType.

É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Você deve usar esse parâmetro com o parâmetro LinkType, o que significa que todos os destinatários especificados receberão a mesma função no Grupo microsoft 365 (você não pode adicionar destinatários com funções diferentes no mesmo comando).

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-LinkType

O parâmetro LinkType especifica a função do destinatário no Grupo microsoft 365 que você deseja adicionar. Os valores válidos são:

  • Membros: participe de conversas, crie canais do Teams, colabore em arquivos e edite o site conectado do SharePoint.
  • Proprietários: adicione ou remova membros, exclua conversas, altere as configurações da equipe, exclua a Equipe e controle total do site do SharePoint conectado. O grupo deve ter pelo menos um proprietário.
  • Assinantes: membros que recebem notificações de eventos de conversa e calendário do grupo. Todos os assinantes são membros do grupo, mas todos os membros não são necessariamente assinantes (dependendo do valor da propriedade AutoSubscribeNewMembers do grupo e quando o membro foi adicionado).

No PowerShell, qualquer proprietário ou assinante que você deseja adicionar ao grupo também deve ser um membro.

Você deve usar esse parâmetro com o parâmetro LinkType.

Type:LinkType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection