Condividi tramite

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

In 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