Condividi tramite

Set-Group (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-17

Il cmdlet Set-Group consente di modificare le impostazioni di un gruppo di Microsoft Windows esistente.

Sintassi

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-DisplayName <String>] [-DomainController <Fqdn>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

Descrizione dettagliata

Il cmdlet Set-Group consente di modificare le impostazioni dell'oggetto gruppo visualizzabile in Utenti e computer di Active Directory. Se si tratta di un gruppo di distribuzione o di un gruppo di protezione abilitato alla posta, è possibile utilizzare il cmdlet Set-DistributionGroup per modificare altre impostazioni di Microsoft Exchange Server 2007 che non sono disponibili tramite il cmdlet Set-Group.

Non è possibile utilizzare il cmdlet Set-Group per modificare gruppi di distribuzione dinamici. A questo scopo, utilizzare il cmdlet Set-DynamicDistributionGroup. Per ulteriori informazioni sul cmdlet Set-DynamicDistributionGroup, vedere Set-DynamicDistributionGroup (RTM).

Per eseguire il cmdlet Set-Group, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Recipient Administrator

  • Ruolo Account Operator per i contenitori applicabili di Active Directory

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Il parametro Identity consente di specificare l'oggetto che si desidera modificare. e può accettare uno dei seguenti valori per il gruppo:

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

Non è possibile utilizzare il parametro Identity se è specificato il parametro Instance.

DisplayName

Facoltativo

System.String

Il parametro DisplayName specifica il nome del gruppo in Exchange Management Console e nell'elenco indirizzi globale (GAL) di Exchange. È rilevante solo se il gruppo è abilitato all'utilizzo della posta.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che scrive la modifica alla configurazione in Active Directory, includere il parametro DomainController.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

Il parametro Instance consente di trasmettere l'intero oggetto al comando da elaborare. Viene utilizzato principalmente negli script in cui è necessario trasmettere l'intero oggetto al comando.

Il parametro Instance non può essere utilizzato nel caso in cui sia specificato il parametro Identity.

ManagedBy

Facoltativo

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Il parametro ManagedBy specifica il nome dell'utente, gruppo o contatto visualizzato nella scheda Gestito da dell'oggetto Active Directory. È possibile utilizzare uno dei seguenti valori per il parametro:

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

Nome

Facoltativo

System.String

Il parametro Name specifica il nome del gruppo. Il nome del gruppo viene specificato in Utenti e computer di Active Directory e, se il gruppo è abilitato all'utilizzo della posta, anche nel campo Nome gruppo in Exchange Management Console.

Note

Facoltativo

System.String

Il parametro Notes specifica le note illustrative dello scopo del gruppo.

PhoneticDisplayName

Facoltativo

System.String

Il parametro PhoneticDisplayName specifica una pronuncia fonetica del parametro DisplayName.

La lunghezza massima del valore di questo parametro è 255 caratteri. Per ulteriori informazioni sul parametro PhoneticDisplayName e sul riconoscimento vocale, vedere Concetti relativi alle ricerche nella directory di riconoscimento vocale automatico.

SimpleDisplayName

Facoltativo

System.String

Il parametro SimpleDisplayName consente di visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato. Tale set di caratteri limitato è composto dai caratteri ASCII compresi tra il carattere 26 e il carattere 126. Il parametro SimpleDisplayName è rilevante solo per oggetti abilitati all'utilizzo della posta.

Universale

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Universal modifica l'ambito del gruppo da global o domain local in universal.

WindowsEmailAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Il parametro WindowsEmailAddress consente di specificare il valore del campo Posta elettronica dell'oggetto Active Directory.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il comando Set-Group per applicare le modifiche seguenti a un gruppo di protezione globale esistente denominato Legal Department:

  • Modificare l'ambito del gruppo impostandolo su universal

  • Aggiungere un valore Notes uguale a verified.

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