Add-UnifiedGroupLinks

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

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

Nota

Non è possibile usare questo cmdlet per modificare i membri, i proprietari o i sottoscrittori del gruppo di Microsoft 365 se ci si connette usando l'autenticazione basata su certificato (nota anche come autenticazione CBA o autenticazione solo app per gli script automatici) o l'identità gestita di Azure. In alternativa, è possibile usare Microsoft Graph. Per ulteriori informazioni, consulta Tipo di risorse del gruppo.

Usando questo cmdlet, solo i membri del gruppo possono essere proprietari del gruppo. Aggiungere gli utenti come membri prima di aggiungerli come proprietari. Questa limitazione non si applica ai portali di gestione Web in cui è possibile aggiungere gli utenti non membri come proprietari del gruppo. Gli utenti guest non possono mai essere proprietari del gruppo.

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

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

I Gruppi di Microsoft 365 sono oggetti gruppo disponibili in tutti i servizi di Microsoft 365.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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.

Nota: Solo i membri possono essere proprietari di un gruppo, pertanto è necessario aggiungere un utente come membro prima di aggiungerlo come proprietario. Gli utenti guest non possono essere proprietari di gruppi, anche se gli utenti sono membri dei gruppi.

Esempio

Esempio 1

Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com

In questo esempio vengono aggiunti membri chris@contoso.com e michelle@contoso.com al gruppo di Microsoft 365 denominati Ufficio legale.

Esempio 2

$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}

Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)

Questo esempio illustra come aggiungere membri in blocco a un gruppo di Microsoft 365. Le cassette postali in cui l'attributo Reparto è "Marketing" vengono aggiunte al gruppo denominato Marketing di Microsoft 365.

Parametri

-Confirm

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Identity consente di specificare il gruppo di Microsoft 365 che si desidera 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

Proprietà dei parametri

Tipo:UnifiedGroupIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Links

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Links consente di specificare i destinatari da aggiungere al 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

È necessario usare questo parametro con il parametro LinkType, che significa che i destinatari specificati ricevono lo stesso ruolo nel gruppo di Microsoft 365 (non è possibile aggiungere destinatari con ruoli diversi nello stesso comando).

Nota: usando questo cmdlet, solo i membri del gruppo possono essere proprietari del gruppo. Aggiungere gli utenti come membri prima di aggiungerli come proprietari. Questa limitazione non si applica ai portali di gestione Web in cui è possibile aggiungere gli utenti non membri come proprietari del gruppo. Gli utenti guest non possono mai essere proprietari del gruppo.

Tipo:

RecipientIdParameter[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LinkType

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro LinkType consente di specificare il ruolo del destinatario nel gruppo di Microsoft 365 che si vuole aggiungere. I valori validi sono:

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

È necessario utilizzare questo parametro con il parametro Links.

Nota: usando questo cmdlet, solo i membri del gruppo possono essere proprietari del gruppo. Aggiungere gli utenti come membri prima di aggiungerli come proprietari. Questa limitazione non si applica ai portali di gestione Web in cui è possibile aggiungere gli utenti non membri come proprietari del gruppo. Gli utenti guest non possono mai essere proprietari del gruppo.

Proprietà dei parametri

Tipo:LinkType
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.