Condividi tramite


Set-User (RTM)

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-05

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

Sintassi

set-User -Identity <UserIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-WindowsEmailAddress <SmtpAddress>]

set-User [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-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 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.UserIdParameter

Il parametro Identity accetta uno dei seguenti valori:

  • GUID

  • Nome distinto (Distinguished Name, DN)

  • Dominio\Account

  • Nome dell'entità utente (UPN, User principal name)

  • Nome distinto legacy di Exchange

  • Indirizzo SMTP (Simple Mail Transfer Protocol)

  • Alias

AssistantName

Facoltativo

System.String

Il parametro AssistantName consente di definire il nome dell'assistente dell'utente.

Città

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.

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.

Iniziali

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 trasmettere l'intero oggetto al comando da elaborare. Viene utilizzato principalmente negli script in cui è necessario trasmettere 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.

Nome

Facoltativo

System.String

Il parametro Name consente di definire il nome comune dell'utente.

Note

Facoltativo

System.String

Il parametro Notes consente di definire ulteriori informazioni sull'utente.

Ufficio

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 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.

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 definire il nome di accesso utilizzato per supportare i client e i server che eseguono versioni precedenti del sistema operativo, quali 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 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.

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.

Title

Facoltativo

System.String

Il parametro Title consente di definire la posizione professionale 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.

WebPage

Facoltativo

System.String

Il parametro WebPage consente di definire la pagina Web dell'utente.

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

  

 

Esempio

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

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