Set-Group

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet Set-Group per modificare le impostazioni dell'oggetto gruppo. Se il gruppo è un gruppo di sicurezza abilitato alla posta elettronica o un gruppo di distribuzione, è possibile usare il cmdlet Set-DistributionGroup per modificare altre impostazioni di Exchange Microsoft non disponibili usando il cmdlet Set-Group.

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

Sintassi

Set-Group
   [-Identity] <GroupIdParameter>
   [-BypassSecurityGroupManagerCheck]
   [-Confirm]
   [-Description <MultiValueProperty>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-IgnoreDefaultScope]
   [-IsHierarchicalGroup <Boolean>]
   [-ManagedBy <GeneralRecipientIdParameter[]>]
   [-Name <String>]
   [-Notes <String>]
   [-PhoneticDisplayName <String>]
   [-SeniorityIndex <Int32>]
   [-SimpleDisplayName <String>]
   [-Universal]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

Descrizione

Non è possibile utilizzare il cmdlet Set-Group per modificare i gruppi di distribuzione dinamici. A questo scopo, utilizzare il cmdlet Set-DynamicDistributionGroup.

È 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

Set-Group -Identity "Legal Department" -Universal -Notes "verified"

Con questo esempio vengono applicate le modifiche seguenti al gruppo di protezione globale esistente Legal Department:

Modificare l'ambito del gruppo impostandolo su universal

Aggiungere il valore verificato del parametro Notes.

Esempio 2

Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1

Con questo esempio viene specificato che il gruppo Human Resources è un gruppo gerarchico e dovrà essere visualizzato per ultimo nella gerarchia perché il suo numero di indice è 1.

Parametri

-BypassSecurityGroupManagerCheck

L'opzione BypassSecurityGroupManagerCheck specifica se consentire a un utente che non è proprietario del gruppo di modificare o eliminare il gruppo. Con questa opzione non è necessario specificare alcun valore.

Se non si è definiti nella proprietà ManagedBy del gruppo, è necessario usare questa opzione nei comandi che modificano o eliminano il gruppo. Per usare questa opzione, l'account richiede autorizzazioni specifiche in base al tipo di gruppo:

  • Gruppi di distribuzione o gruppi di sicurezza abilitati alla posta elettronica: è necessario essere membri del gruppo di ruoli Gestione organizzazione o assegnare il ruolo Creazione e appartenenza al gruppo di sicurezza.
  • Gruppi di distribuzione o gruppi di protezione abilitati alla posta elettronica: è necessario essere membri del gruppo di ruoli Gestione organizzazione oppure disporre del ruolo Creazione e appartenenza a un gruppo di protezione.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Description

Questo parametro è disponibile solamente nel servizio basato su cloud.

{{ Descrizione riempimento }}

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DisplayName

Il parametro DisplayName consente di specificare il nome visualizzato del gruppo. Il nome visualizzato è visibile nell'interfaccia di amministrazione di Exchange e negli elenchi di indirizzi. La lunghezza massima è 256 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Questo parametro è significativo solo se il gruppo è abilitato alla posta elettronica.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Il parametro Identity consente di specificare il gruppo che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il gruppo in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • Nome distinto (DN)
  • GUID
Type:GroupIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

Questo parametro è disponibile solo in Exchange locale.

L'opzione IgnoreDefaultScope indica al comando di ignorare l'impostazione dell'ambito del destinatario predefinito per la sessione di Exchange PowerShell e di usare l'intera foresta come ambito. Con questa opzione non è necessario specificare alcun valore.

Questa opzione consente al comando di accedere agli oggetti active directory attualmente non disponibili nell'ambito predefinito, ma introduce anche le restrizioni seguenti:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizza automaticamente un server di catalogo globale appropriato.
  • È possibile utilizzare solo il DN per il parametro Identity. Non vengono accettate altre forme di identificazione, ad esempio alias o GUID.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsHierarchicalGroup

Il parametro IsHierarchicalGroup consente di specificare se il gruppo è parte di una rubrica gerarchica. I valori validi sono $true o $false. Il valore predefinito è $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ManagedBy

Il parametro ManagedBy consente di specificare un proprietario per il gruppo. Un gruppo deve disporre di almeno un proprietario. Se non si usa questo parametro per specificare il proprietario quando si crea il gruppo, l'account utente che ha creato il gruppo è il proprietario. Il proprietario del gruppo è in grado di:

  • Il parametro ManagedBy consente di specificare un proprietario del gruppo. Un gruppo deve disporre di almeno un proprietario. Se non si utilizza questo parametro per specificare il proprietario quando si crea il gruppo, l'account utente che ha creato il gruppo ne diventa il proprietario. Il proprietario del gruppo è in grado di:
  • Modificare le proprietà del gruppo.
  • Aggiungere o rimuovere membri del gruppo
  • Eliminare il gruppo
  • Approvare le richieste dei membri che desiderano unirsi al gruppo o uscirne (se disponibile)

Il proprietario specificato per questo parametro deve essere una cassetta postale, un utente di posta elettronica o un gruppo di sicurezza abilitato alla posta elettronica (un'entità di sicurezza abilitata per la posta che può avere le autorizzazioni assegnate). È possibile utilizzare qualsiasi valore che identifichi il proprietario in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

Per immettere più proprietari e sovrascrivere tutte le voci esistenti, usare la sintassi seguente: Owner1,Owner2,...OwnerN. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Owner1","Owner2",..."OwnerN".

Per aggiungere o rimuovere proprietari senza influire su altre voci esistenti, usare la sintassi seguente: @{Add="Owner1","Owner2",...; Remove="Owner3","Owner4"...}.

I proprietari specificati con questo parametro non vengono aggiunti come membri del gruppo. È necessario aggiungere manualmente i proprietari come membri.

Nota: la gestione dei gruppi in Outlook non funziona quando il proprietario è un gruppo di sicurezza abilitato alla posta elettronica. Per gestire il gruppo in Outlook, il proprietario deve essere una cassetta postale o un utente di posta elettronica.

Type:GeneralRecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Il parametro Name specifica il nome univoco del gruppo. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Notes

Il parametro Notes consente di specificare informazioni aggiuntive sull'oggetto. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

Il parametro PhoneticDisplayName consente di specificare un'ortografia alternativa del nome dell'utente per la sintesi vocale in ambienti di Messaggistica unificata (UM). In genere, si utilizza questo parametro quando non vi è una corrispondenza tra la pronuncia e l'ortografia del nome dell'utente. La lunghezza massima è 256 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SeniorityIndex

Il parametro SeniorityIndex consente di specificare l'ordine in cui viene visualizzato questo gruppo in una rubrica gerarchica. Un gruppo con valore pari a 2 viene visualizzato più in alto nella rubrica di un gruppo con valore 1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

Il parametro SimpleDisplayName viene utilizzato per visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato. I caratteri validi sono:

  • a - z
  • A - Z
  • 0 - 9
  • spazio
  • " ' ( ) + , - . / : ?

Questo parametro è significativo solo se il gruppo è abilitato alla posta elettronica.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Universal

L'opzione Universale modifica l'ambito del gruppo da Globale o DominioLocale a Universale. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

Il parametro WindowsEmailAddress specifica l'indirizzo di posta elettronica di Windows per questo destinatario. Si tratta di un attributo di Active Directory comune presente in tutti gli ambienti, inclusi gli ambienti senza Exchange. L'uso del parametro WindowsEmailAddress in un destinatario ha uno dei risultati seguenti:

  • Negli ambienti in cui il destinatario è soggetto a criteri di indirizzo di posta elettronica (la proprietà EmailAddressPolicyEnabled è impostata sul valore True per il destinatario), il parametro WindowsEmailAddress non ha alcun effetto sulla proprietà WindowsEmailAddress o sul valore dell'indirizzo di posta elettronica primario.
  • Negli ambienti in cui il destinatario non è soggetto a criteri di indirizzo di posta elettronica (la proprietà EmailAddressPolicyEnabled è impostata sul valore False per il destinatario), il parametro WindowsEmailAddress aggiorna la proprietà WindowsEmailAddress e l'indirizzo di posta elettronica primario allo stesso valore.

La proprietà WindowsEmailAddress è visibile per il destinatario in Utenti e computer di Active Directory nell'attributo Posta elettronica. Il nome comune dell'attributo è E-mail-Addresses e Ldap-Display-Name è mail. Se si modifica questo attributo in Active Directory, l'indirizzo di posta elettronica primario del destinatario non viene aggiornato allo stesso valore.

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.