Set-User

  • Articolo

 

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