Set-User (RTM)
適用版本: Exchange Server 2007
上次修改主題的時間: 2007-06-05
使用 Set-User 指令程式可修改 Active Directory 目錄服務中的使用者屬性。
語法
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>]
詳細描述
Set-User 指令程式可修改 Active Directory 中現有使用者的屬性。
若要執行 Set-User 指令程式,必須對您使用的帳戶委派下列項目:
- Exchange 收件者系統管理員角色
- 適當 Active Directory 容器的帳戶操作員角色
如需管理 Exchange Server 2007 所需之權限、委派角色及權利的相關資訊,請參閱權限考量。
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
Identity 參數使用下列其中一個值:
|
AssistantName |
選用 |
System.String |
AssistantName 參數可定義使用者助理員的名字。 |
City |
選用 |
System.String |
City 參數可定義使用者的縣/市。 |
Company |
選用 |
System.String |
Company 參數可定義使用者的公司。 |
CountryOrRegion |
選用 |
Microsoft.Exchange.Data.Directory.CountryInfo |
CountryOrRegion 參數可定義使用者的國家或地區。 |
CreateDTMFMap |
選用 |
System.Boolean |
此參數指定為使用者建立雙音多頻 (DTMF) 對應。 |
Department |
選用 |
System.String |
Department 參數可定義使用者的部門。 |
DisplayName |
選用 |
System.String |
DisplayName 參數可定義使用者的顯示名稱。 |
DomainController |
選用 |
Microsoft.Exchange.Data.Fqdn |
若要指定將此組態變更寫入至 Active Directory 之網域控制站的網域全名 (FQDN),請在命令中加入 DomainController 參數。 |
Fax |
選用 |
System.String |
Fax 參數可定義使用者的傳真號碼。 |
FirstName |
選用 |
System.String |
FirstName 參數可定義使用者的名字。 |
HomePhone |
選用 |
System.String |
HomePhone 參數可定義使用者的住家電話號碼。 |
Initials |
選用 |
System.String |
Initials 參數可定義使用者的縮寫。 |
Instance |
選用 |
Microsoft.Exchange.Data.Directory.Management.User |
Instance 參數可讓您將整個物件傳遞至要處理的命令。它主要是用於必須將整個物件傳遞至該命令的指令碼。 |
LastName |
選用 |
System.String |
LastName 參數可定義使用者的姓氏。 |
Manager |
選用 |
Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter |
Manager 參數可定義使用者的主管。 |
MobilePhone |
選用 |
System.String |
MobilePhone 參數可定義使用者的主要行動電話號碼。 |
Name |
選用 |
System.String |
Name 參數可定義使用者的一般名稱。 |
Notes |
選用 |
System.String |
Notes 參數可定義使用者的其他相關資訊。 |
Office |
選用 |
System.String |
Office 參數可定義使用者的實際辦公室名稱或號碼。 |
OtherFax |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
OtherFax 參數可定義使用者的替代傳真號碼。 |
OtherHomePhone |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
OtherHomePhone 參數可定義使用者的替代住家電話號碼。 |
OtherTelephone |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
OtherTelephone 參數可定義使用者的替代電話號碼。 |
Pager |
選用 |
System.String |
Pager 參數可定義使用者的呼叫器號碼。 |
Phone |
選用 |
System.String |
Phone 參數可定義使用者的辦公室電話號碼。 |
PhoneticDisplayName |
選用 |
System.String |
PhoneticDisplayName 參數指定 DisplayName 參數的語音讀法。 此參數值的最大長度為 255 個字元。如需 PhoneticDisplayName 參數與語音辨識的相關資訊,請參閱了解自動語音辨識目錄查閱服務。 |
PostalCode |
選用 |
System.String |
PostalCode 參數可定義使用者的郵遞區號。 |
PostOfficeBox |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
PostOfficeBox 參數可定義使用者的郵政信箱號碼。 |
ResetPasswordOnNextLogon |
選用 |
System.Boolean |
ResetPasswordOnNextLogon 參數可指定在下次使用者登入時是否必須重設 Password 參數中所指定的密碼。預設值為 $true。 |
SamAccountName |
選用 |
System.String |
SamAccountName 參數定義用來支援執行舊版作業系統 (如 Microsoft Windows NT 4.0、Windows 98、Windows 95 及 LAN Manager) 之用戶端及伺服器的登入名稱。此屬性必須包含少於 20 個字元。 |
SimpleDisplayName |
選用 |
System.String |
SimpleDisplayName 參數是在只允許有限的一組字元時,用來顯示物件的替代性描述。這組有限的字元是由 ASCII 字元 26 到 126 所組成。 |
StateOrProvince |
選用 |
System.String |
StateOrProvince 參數可定義使用者的州或省。 |
StreetAddress |
選用 |
System.String |
StreetAddress 參數可定義使用者的實際地址。 |
Title |
選用 |
System.String |
Title 參數可定義使用者的職稱。 |
UMDialPlan |
選用 |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
此參數指定撥號對應表的目錄物件識別碼。 |
UMDtmfMap |
選用 |
Microsoft.Exchange.Data.MultiValuedProperty |
此參數指定是否要為已啟用 UM 的使用者建立使用者定義之 DTMF 對應。 |
UserPrincipalName |
選用 |
System.String |
UserPrincipalName 參數可定義使用者的使用者主要名稱 (UPN)。 |
WebPage |
選用 |
System.String |
WebPage 參數可定義使用者的網頁。 |
WindowsEmailAddress |
選用 |
Microsoft.Exchange.Data.SmtpAddress |
WindowsEmailAddress 參數可指定收件者的電子郵件地址。 |
輸入類型
傳回類型
錯誤
錯誤 | 描述 |
---|---|
|
|
例外狀況
例外狀況 | 描述 |
---|---|
|
|
範例
在下列範例中,Set-User 命令用於設定使用者 Ted Bremer 的顯示名稱。
Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer"
若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.