Add-UnifiedGroupLinks

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Add-UnifiedGroupLinks per aggiungere membri, proprietari e sottoscrittori a Gruppi di Microsoft 365 nell'organizzazione basata sul 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 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 certificati 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.

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 nei portali di gestione Web in cui è possibile aggiungere 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

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

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

Esempio

Esempio 1

Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links [email protected],[email protected]

In questo esempio vengono aggiunti membri [email protected] e [email protected] al gruppo di Microsoft 365 denominato Legal Department.

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 bulk a un gruppo di Microsoft 365. Le cassette postali in cui l'attributo Department è "Marketing" vengono aggiunte al gruppo di Microsoft 365 denominato Marketing.

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-*) 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	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

Tipo:	UnifiedGroupIdParameter
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False
Si applica a:	Exchange Online, Exchange Online Protection

-Links

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, ovvero 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 nei portali di gestione Web in cui è possibile aggiungere non membri come proprietari del gruppo. Gli utenti guest non possono mai essere proprietari del gruppo.

Tipo:	RecipientIdParameter[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Online, Exchange Online Protection

-LinkType

Il parametro LinkType consente di specificare il ruolo del destinatario nel gruppo di Microsoft 365 da aggiungere. 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 del gruppo esistenti 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 Links.

Tipo:	LinkType
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	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.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False
Si applica a:	Exchange Online, Exchange Online Protection

Condividi tramite