Add-UnifiedGroupLinks

Módulo:
Exchange PowerShell

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

Usando esse cmdlet, somente os membros do grupo podem ser proprietários do grupo. Adicione usuários como membros antes de adicioná-los como proprietários. Essa limitação não se aplica a portais de gerenciamento da Web onde você pode adicionar não membros como proprietários do grupo. Os usuários convidados nunca podem ser proprietários de grupos.

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

Sintaxe

Default (Default) 

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

Description

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

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 membros podem ser proprietários de um grupo, portanto, você deve primeiro 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 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 denominado 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. As caixas de correio em que o atributo do Departamento é "Marketing" são adicionadas ao Grupo do Microsoft 365 chamado Marketing.

Parâmetros

-Confirm

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

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

-Identity

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro Identity especifica o Grupo do 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

Propriedades do parâmetro

Tipo:UnifiedGroupIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-Links

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro Links especifica os destinatários a serem adicionados ao Grupo do Microsoft 365. Especifique 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 os destinatários especificados recebem a mesma função no Grupo do Microsoft 365 (você não pode adicionar destinatários com funções diferentes no mesmo comando).

Observação: usando este cmdlet, somente os membros do grupo podem ser proprietários do grupo. Adicione usuários como membros antes de adicioná-los como proprietários. Essa limitação não se aplica a portais de gerenciamento da Web onde você pode adicionar não membros como proprietários do grupo. Os usuários convidados nunca podem ser proprietários de grupos.

Tipo:

RecipientIdParameter[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LinkType

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro LinkType especifica a função do destinatário no Grupo do 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 do SharePoint conectado.
  • 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 existentes do grupo que recebem notificações de eventos de calendário e conversa do grupo. Todos os assinantes são membros do grupo, mas nem todos os membros são necessariamente assinantes (dependendo do valor da propriedade AutoSubscribeNewMembers do grupo e de quando o membro foi adicionado).

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

Observação: usando este cmdlet, somente os membros do grupo podem ser proprietários do grupo. Adicione usuários como membros antes de adicioná-los como proprietários. Essa limitação não se aplica a portais de gerenciamento da Web onde você pode adicionar não membros como proprietários do grupo. Os usuários convidados nunca podem ser proprietários de grupos.

Propriedades do parâmetro

Tipo:LinkType
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

-WhatIf

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

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

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.