Remove-UnifiedGroupLinks

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Remove-UnifiedGroupLinks per rimuovere membri, proprietari e sottoscrittori da Gruppi di Microsoft 365 nell'organizzazione basata sul cloud. Per aggiungere membri, proprietari e sottoscrittori, usare il cmdlet Add-UnifiedGroupLinks. Per modificare altre proprietà di Gruppi di Microsoft 365, usare il cmdlet Set-UnifiedGroup.

Nota: non è possibile usare questo cmdlet per modificare membri, proprietari o sottoscrittori del gruppo di Microsoft 365 se ci si connette usando l'autenticazione basata su certificato (nota anche come autenticazione basata su certificato o autenticazione solo app per script automatici) o l'identità gestita di Azure. In alternativa, è possibile usare Microsoft Graph. Per altre informazioni, vedere Tipo di risorsa gruppo.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

Gruppi di Microsoft 365 sono oggetti gruppo disponibili nei servizi di Microsoft 365.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

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

In questo esempio vengono rimossi i membri laura@contoso.com e julia@contoso.com dal gruppo di Microsoft 365 denominato Legal Department.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

Il parametro Identity consente di specificare il gruppo di Microsoft 365 da modificare. È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo di Microsoft 365. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • 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

Il parametro Links consente di specificare i destinatari da rimuovere dal gruppo di Microsoft 365. Specificare se i destinatari sono membri, proprietari o sottoscrittori utilizzando il parametro LinkType.

È possibile utilizzare qualsiasi valore che identifichi il destinatario in modo univoco. Esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

È necessario usare questo parametro con il parametro LinkType, ovvero tutti i destinatari specificati verranno rimossi dallo stesso ruolo nel gruppo di Microsoft 365 (non è possibile rimuovere ruoli diversi da destinatari specifici nello stesso 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

Il parametro LinkType consente di specificare il ruolo del destinatario nel gruppo di Microsoft 365 da rimuovere. I valori validi sono:

  • Membri: partecipare alle conversazioni, creare canali di Teams, collaborare ai file e modificare il sito di SharePoint connesso.
  • Proprietari: aggiungere o rimuovere membri, eliminare conversazioni, modificare le impostazioni del team, eliminare il team e il controllo completo del sito di SharePoint connesso. Un gruppo deve disporre di almeno un proprietario.
  • Sottoscrittori: membri che ricevono notifiche di eventi di conversazione e calendario dal gruppo. Tutti i sottoscrittori sono membri del gruppo, ma tutti i membri non sono necessariamente sottoscrittori (a seconda del valore della proprietà AutoSubscribeNewMembers del gruppo e quando è stato aggiunto il membro).

È necessario utilizzare questo parametro con il parametro 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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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