Add-UnifiedGroupLinks
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 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
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 chris@contoso.com,michelle@contoso.comIn questo esempio vengono aggiunti membri chris@contoso.com e michelle@contoso.com 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-*, 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 aggiungere al gruppo di Microsoft 365. È possibile specificare se questi destinatari sono membri, proprietari o sottoscrittori usando 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 i destinatari specificati riceveranno tutti lo stesso ruolo nel gruppo di Microsoft 365 (non è possibile aggiungere destinatari con ruoli diversi 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 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 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).
In PowerShell anche qualsiasi proprietario o sottoscrittore che si vuole aggiungere al gruppo deve essere 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 |
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per