Remove-UnifiedGroupLinks

Módulo:
Exchange PowerShell

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

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

Sintaxe

Default (Default) 

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

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 do Microsoft 365 chamado Departamento Jurídico.

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 removidos do Grupo do Microsoft 365. Você especifica se esses destinatários eram 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 são removidos da mesma função no Grupo do Microsoft 365 (você não pode remover destinatários de funções diferentes no mesmo comando).

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 TipoVínculo especifica a função do destinatário no Grupo do 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 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.

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.