Remove-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 Remove-UnifiedGroupLinks para remover membros, proprietários e assinantes de Grupos do Microsoft 365 em sua organização baseada em nuvem. Para adicionar membros, proprietários e assinantes, use o cmdlet Add-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

Remove-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.

Exemplos

Exemplo 1

Remove-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links laura@contoso.com,julia@contoso.com

Este exemplo remove membros laura@contoso.com e julia@contoso.com do Grupo microsoft 365 chamado Departamento Jurídico.

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 removidos do Grupo 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 todos os destinatários especificados serão removidos da mesma função no Grupo microsoft 365 (você não pode remover funções diferentes de destinatários específicos 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 remover. 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).

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