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:
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:
|
||
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:
|
||
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 |
||
UseRusServer |
Facoltativo |
System.String |
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"