Add-UnifiedGroupLinks
Esse cmdlet só está disponível no serviço baseado em nuvem.
Utilize o cmdlet Add-UnifiedGroupLinks para adicionar membros, proprietários e subscritores a Grupos do Microsoft 365 na sua organização com base na cloud. Para remover membros, proprietários e subscritores, utilize o cmdlet Remove-UnifiedGroupLinks. Para modificar outras propriedades de Grupos do Microsoft 365, utilize o cmdlet Set-UnifiedGroup.
Observação
Não pode utilizar este cmdlet para modificar membros, proprietários ou subscritores do Grupo do Microsoft 365 se se ligar através da autenticação baseada em certificados (também conhecida como CBA ou autenticação apenas de aplicação para scripts autónomos) ou Azure identidade gerida. Em vez disso, você pode usar o Microsoft Graph. Para obter mais informações, veja Tipo de recurso de grupo.
Com este cmdlet, apenas os membros do grupo podem ser proprietários do grupo. Adicione utilizadores como membros antes de os adicionar como proprietários. Esta limitação não se aplica nos portais de gestão Web onde pode adicionar não membros como proprietários de grupos. Os utilizadores 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 em todos os serviços do Microsoft 365.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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.
Nota: apenas os membros podem ser proprietários de um grupo, pelo que primeiro tem de adicionar um utilizador como membro antes de o adicionar como proprietário. Os utilizadores convidados não podem ser proprietários de grupos, mesmo que os utilizadores 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 Departamento é "Marketing" são adicionadas ao Grupo do Microsoft 365 denominado Marketing.
Parâmetros
-Confirm
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
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, 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 confirmar 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, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Identidade especifica o Grupo do Microsoft 365 que pretende modificar. Pode utilizar 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, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Ligações especifica os destinatários a adicionar 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".
Tem de utilizar este 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 (não pode adicionar destinatários com funções diferentes no mesmo comando).
Nota: ao utilizar este cmdlet, apenas os membros do grupo podem ser proprietários do grupo. Adicione utilizadores como membros antes de os adicionar como proprietários. Esta limitação não se aplica nos portais de gestão Web onde pode adicionar não membros como proprietários de grupos. Os utilizadores convidados nunca podem ser proprietários de grupos.
Propriedades do parâmetro
| Tipo: | RecipientIdParameter[] |
| 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 |
-LinkType
Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro LinkType especifica a função do destinatário no Grupo do Microsoft 365 que pretende adicionar. Os valores válidos são:
- Membros: participe em conversações, crie canais do Teams, colabore em ficheiros e edite o site do SharePoint ligado.
- Proprietários: adicione ou remova membros, elimine conversações, altere as Definições da equipa, elimine a Equipa e o controlo total do site do SharePoint ligado. O grupo deve ter pelo menos um proprietário.
- Subscritores: membros do grupo existentes que recebem notificações de eventos de conversação e calendário do grupo. Todos os subscritores são membros do grupo, mas todos os membros não são necessariamente subscritores (dependendo do valor da propriedade AutoSubscribeNewMembers do grupo e quando o membro foi adicionado).
Tem de utilizar este parâmetro com o parâmetro Ligações.
Nota: ao utilizar este cmdlet, apenas os membros do grupo podem ser proprietários do grupo. Adicione utilizadores como membros antes de os adicionar como proprietários. Esta limitação não se aplica nos portais de gestão Web onde pode adicionar não membros como proprietários de grupos. Os utilizadores 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, Suplemento de segurança incorporado para caixas de correio no local
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.
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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.