Set-User

 

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

Ultima modifica dell'argomento: 2011-01-12

Il cmdlet Set-User consente di impostare gli attributi utente nel servizio directory di Active Directory.

Sintassi

set-User -Identity <UserIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-User [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-Instance <User>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrizione dettagliata

Il cmdlet Set-User modifica gli attributi di un utente esistente in Active Directory.

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

• Ruolo Exchange Recipient Administrator

• Ruolo Account Operator per i contenitori di Active Directory appropriati 

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.UserIdParameter	Il parametro Identity accetta uno dei seguenti valori: GUID Nome distinto (DN) Dominio\Account Nome dell'entità utente DN legacy di Exchange Indirizzo SMTP (Simple Mail Transfer Protocol) Alias
AllowUMCallsFromNonUsers	Facoltativo	Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags	Questo parametro consente di specificare se escludere l'utente dalle ricerche di directory.
AssistantName	Facoltativo	System.String	Il parametro AssistantName consente di definire il nome dell'assistente dell'utente.
City	Facoltativo	System.String	Il parametro City consente di definire la città dell'utente.
Company	Facoltativo	System.String	Il parametro Company consente di definire l'azienda dell'utente.
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.
CountryOrRegion	Facoltativo	Microsoft.Exchange.Data.Directory.CountryInfo	Il parametro CountryOrRegion consente di definire il paese o l'area geografica dell'utente.
CreateDTMFMap	Facoltativo	System.Boolean	Questo parametro consente di specificare una mappa DTMF (Dual Tone Multi-Frequency) da creare per l'utente.
Department	Facoltativo	System.String	Il parametro Department consente di definire il reparto dell'utente.
DisplayName	Facoltativo	System.String	Il parametro DisplayName consente di definire il nome visualizzato dell'utente.
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 nel comando il parametro DomainController.
Fax	Facoltativo	System.String	Il parametro Fax consente di definire il numero di fax dell'utente.
FirstName	Facoltativo	System.String	Il parametro FirstName consente di definire il nome dell'utente.
HomePhone	Facoltativo	System.String	Il parametro HomePhone consente di definire il numero di telefono dell'abitazione dell'utente.
IgnoreDefaultScope	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro IgnoreDefaultScope consente di indicare al comando di ignorare l'impostazione dell'ambito destinatari predefinita di 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. L'utilizzo del parametro IgnoreDefaultScope presenta le seguenti restrizioni: Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente un server di catalogo globale appropriato. È possibile utilizzare solo il DN per il parametro Identity. Non sono accettate altre forme di identificazione, ad esempio alias o GUID.
Initials	Facoltativo	System.String	Il parametro Initials consente di definire le iniziali dell'utente.
Instance	Facoltativo	Microsoft.Exchange.Data.Directory.Management.User	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.
LastName	Facoltativo	System.String	Il parametro LastName consente di definire il cognome dell'utente.
Manager	Facoltativo	Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter	Il parametro Manager consente di definire il responsabile dell'utente.
MobilePhone	Facoltativo	System.String	Il parametro MobilePhone consente di definire il numero di cellulare principale dell'utente.
Name	Facoltativo	System.String	Il parametro Name consente di definire il nome comune dell'utente.
Notes	Facoltativo	System.String	Il parametro Notes consente di definire ulteriori informazioni sull'utente.
Office	Facoltativo	System.String	Il parametro Office consente di definire il numero o il nome dell'ufficio fisico dell'utente.
OtherFax	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro OtherFax consente di definire il numero di fax alternativo dell'utente.
OtherHomePhone	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro OtherHomePhone consente di definire il numero di telefono alternativo dell'abitazione dell'utente.
OtherTelephone	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro OtherTelephone consente di definire il numero di telefono alternativo dell'utente.
Pager	Facoltativo	System.String	Il parametro Pager consente di definire il numero di cercapersone dell'utente.
Phone	Facoltativo	System.String	Il parametro Phone consente di definire il numero di telefono dell'ufficio dell'utente.
PhoneticDisplayName	Facoltativo	System.String	Il parametro PhoneticDisplayName consente di specificare la pronuncia fonetica del parametro DisplayName. La lunghezza massima del valore di questo parametro è di 255 caratteri. Per ulteriori informazioni sul parametro PhoneticDisplayName e sul riconoscimento vocale, vedere Concetti relativi alle ricerche nella directory di riconoscimento vocale automatico.
PostalCode	Facoltativo	System.String	Il parametro PostalCode consente di definire il CAP dell'utente.
PostOfficeBox	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro PostOfficeBox consente di definire il numero di casella postale dell'utente.
ResetPasswordOnNextLogon	Facoltativo	System.Boolean	Il parametro ResetPasswordOnNextLogon consente di specificare se è necessario reimpostare la password inserita nel parametro Password al successivo accesso dell'utente. Il valore predefinito è $true.
SamAccountName	Facoltativo	System.String	Il parametro SamAccountName consente di specificare il nome di accesso utilizzato per supportare client e server che eseguono versioni precedenti del sistema operativo, ad esempio Microsoft Windows NT 4.0, Windows 98, Windows 95 e LAN Manager. Questo attributo deve includere meno di 20 caratteri.
SimpleDisplayName	Facoltativo	System.String	Il parametro SimpleDisplayName viene utilizzato per visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato. Tale set di caratteri limitato è composto dai seguenti caratteri: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?
StateOrProvince	Facoltativo	System.String	Il parametro StateOrProvince consente di definire lo Stato o la provincia dell'utente.
StreetAddress	Facoltativo	System.String	Il parametro StreetAddress consente di definire l'indirizzo fisico dell'utente.
TelephoneAssistant	Facoltativo	System.String	Il parametro TelephoneAssistant consente di definire il numero di telefono dell'assistente dell'utente.
Title	Facoltativo	System.String	Il parametro Title consente di definire la posizione dell'utente.
UMDialPlan	Facoltativo	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Questo parametro consente di specificare l'ID della directory del dial plan.
UMDtmfMap	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro consente di specificare se si intende creare una mappa DTMF definita dall'utente per l'utente abilitato alla messaggistica unificata.
UserPrincipalName	Facoltativo	System.String	Il parametro UserPrincipalName specifica il nome dell'entità utente (UPN, User Principal Name) relativo all'utente stesso.
UseRusServer	Facoltativo	System.String	Nota: 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 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.
WebPage	Facoltativo	System.String	Il parametro WebPage consente di definire la pagina Web dell'utente.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire 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 consente di specificare l'indirizzo di posta elettronica del destinatario.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempi

Descrizione

Nel seguente esempio il comando Set-User viene utilizzato per impostare il nome visualizzato per l'utente Ted Bremer.

Codice

Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer" 

Descrizione

Nel seguente esempio il comando Set-User è utilizzato per rimuovere il valore -manager. Per eseguire questa operazione, è necessario specificare $null come indicato di seguito.

Codice

Set-User -Identity Contoso\Ted -manager $null