Condividi tramite


Set-Group

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-12

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

Sintassi

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

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

Set-Group [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-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 eseguire il cmdlet Set-Group, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Recipient Administrator

  • Ruolo Account Operator per i contenitori di Active Directory applicabili

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 da modificare e può accettare uno dei seguenti valori per il gruppo:

  • Nome distinto (DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

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

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.

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 consente di scrivere la modifica alla configurazione in Active Directory, includere il parametro DomainController.

IgnoreDefaultScope

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro IgnoreDefaultScope consente al comando di ignorare l'impostazione predefinita dell'ambito dei destinatari Exchange Management Shell e di utilizzare l'intera foresta come ambito. Ciò consente al comando di accedere agli oggetti di Active Directory che non si trovano correntemente nell'ambito predefinito. Utilizzando il parametro IgnoreDefaultScope si introducono le seguenti restrizioni:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente un server di catalogo globale appropriato.

  • È possibile utilizzare solo il nome distinto (DN) per il parametro Identity. Non sono accettate altre forme di identificazione, ad esempio alias o GUID.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

Il parametro Instance consente di passare l'intero oggetto al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.

Il parametro Instance non può essere utilizzato se è 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 (DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

Name

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.

Notes

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.

Universal

Facoltativo

System.Management.Automation.SwitchParameter

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

UseRusServer

Facoltativo

System.String

noteNota:
Questo parametro è disponibile solo in Exchange 2007 SP2.

Il parametro UseRusServer consente al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e impostare la cassetta postale e gli attributi dell'utente di Active Directory.

Il Servizio elenco indirizzi è un componente del servizio Supervisore sistema di Exchange. Il Servizio elenco indirizzi consente di creare e gestire i valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio elenco indirizzi per aggiornare gli oggetti destinatario in un dominio utilizzando informazioni specifiche, come l'appartenenza a un elenco di indirizzi e gli indirizzi di posta elettronica.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente di indicare al comando di simulare le azioni da intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

WindowsEmailAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Il parametro WindowsEmailAddress specifica 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"