Set-User
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 Set-User Cmdlet 來修改使用者屬性。 您可以使用此 Cmdlet 來修改具有使用者帳戶的所有物件 (例如,使用者信箱、郵件使用者和使用者帳戶) 。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Set-User
[-Identity] <UserIdParameter>
[-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
[-Arbitration]
[-AssistantName <String>]
[-AuthenticationPolicy <String>]
[-BlockCloudCache <Boolean>]
[-CanHaveCloudCache <Boolean>]
[-CertificateSubject <MultiValuedProperty>]
[-City <String>]
[-ClearDataEncryptionPolicy]
[-Company <String>]
[-Confirm]
[-CountryOrRegion <CountryInfo>]
[-CreateDTMFMap <Boolean>]
[-Department <String>]
[-DesiredWorkloads <MailboxWorkloadFlags>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-Fax <String>]
[-FirstName <String>]
[-Force]
[-GeoCoordinates <GeoCoordinates>]
[-HomePhone <String>]
[-IgnoreDefaultScope]
[-Initials <String>]
[-LastName <String>]
[-LinkedCredential <PSCredential>]
[-LinkedDomainController <String>]
[-LinkedMasterAccount <UserIdParameter>]
[-MailboxRegion <String>]
[-MailboxRegionSuffix <MailboxRegionSuffixValue>]
[-Manager <UserContactIdParameter>]
[-MobilePhone <String>]
[-Name <String>]
[-Notes <String>]
[-Office <String>]
[-OtherFax <MultiValuedProperty>]
[-OtherHomePhone <MultiValuedProperty>]
[-OtherTelephone <MultiValuedProperty>]
[-Pager <String>]
[-PermanentlyClearPreviousMailboxInfo]
[-Phone <String>]
[-PhoneticDisplayName <String>]
[-PostalCode <String>]
[-PostOfficeBox <MultiValuedProperty>]
[-PublicFolder]
[-RemotePowerShellEnabled <Boolean>]
[-RemoveMailboxProvisioningConstraint]
[-ResetPasswordOnNextLogon <Boolean>]
[-SamAccountName <String>]
[-SeniorityIndex <Int32>]
[-SimpleDisplayName <String>]
[-SkipDualWrite]
[-StateOrProvince <String>]
[-StreetAddress <String>]
[-StsRefreshTokensValidFrom <DateTime>]
[-TelephoneAssistant <String>]
[-Title <String>]
[-UMCallingLineIds <MultiValuedProperty>]
[-UMDtmfMap <MultiValuedProperty>]
[-UserPrincipalName <String>]
[-VIP <Boolean>]
[-WebPage <String>]
[-WhatIf]
[-WindowsEmailAddress <SmtpAddress>]
[<CommonParameters>]
Description
Set-User Cmdlet 不包含信箱或郵件使用者的郵件相關屬性。 若要修改使用者的郵件相關屬性,您必須根據物件類型 (使用對應的 Cmdlet,例如,Set-Mailbox或 Set-MailUser) 。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-User -Identity Contoso\Jill -DisplayName "Jill Frank"
本範例設定使用者 Jill Frank 的顯示名稱。
範例 2
Set-User -Identity Kweku@fabrikam.com -LinkedMasterAccount $null
本範例會將連結的信箱 Kweku@fabrikam.com 取消連結,並將它轉換為使用者信箱,方法是將 LinkedMasterAccount 參數設定為 $null。
在連結的信箱上執行此程式會移除信箱上的擁有權限,例如傳送身分、完整存取、資料夾和行事曆委派。
參數
-AllowUMCallsFromNonUsers
此參數僅適用於內部部署 Exchange。
AllowUMCallsFromNonUsers 參數會指定是否要從整合通訊目錄搜尋中排除使用者。
Type: | AllowUMCallsFromNonUsersFlags |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Arbitration
此參數僅適用於內部部署 Exchange。
需要仲裁參數才能修改仲裁信箱。 您不需要使用此參數指定值。
仲裁信箱是用來儲存不同類型系統資料及管理訊息核准工作流程的系統信箱。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AssistantName
AssistantName 參數會指定使用者助理員的名字。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-AuthenticationPolicy
AuthenticationPolicy 參數會指定要套用至使用者的驗證原則。 您可以使用唯一識別原則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
若要移除使用者的原則指派,請使用值$null。
您可以使用 New-AuthenticationPolicy Cmdlet 建立驗證原則,以封鎖或選擇性地允許 Exchange 2019 CU2 或更新版本中的基本驗證或 (,) 其他舊版驗證方法。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019, Exchange Online, Exchange Online Protection |
-BlockCloudCache
此參數只能在雲端式服務中使用。
{{ Fill BlockCloudCache Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CanHaveCloudCache
此參數只能在雲端式服務中使用。
{{ Fill CanHaveCloudCache Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CertificateSubject
此參數僅適用於內部部署 Exchange。
CertificateSubject 參數會指定使用者數位憑證的主旨欄位值。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-City
City 參數會指定使用者所在的城市。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ClearDataEncryptionPolicy
此參數只能在雲端式服務中使用。
{{ Fill ClearDataEncryptionPolicy Description }}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Company
Company 參數會指定使用者的公司。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false
。 - 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CountryOrRegion
CountryOrRegion 參數會指定使用者所在的國家或地區。 有效的值是有效的 ISO 3166-1 兩個字母的國家/地區代碼 (例如,澳大利亞) 的 AU,或與官方 ISO 3166 維護機構簡短名稱) 不同的國家/地區 (對應的易記名稱。
兩個字母的國家/地區代碼參考可在國家/ 地區代碼清單取得。
Get-User Cmdlet 會在 CountryOrRegion 屬性值中傳回易記名稱,但您可以在篩選作業中使用易記名稱或兩個字母的國家/地區代碼。
Type: | CountryInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CreateDTMFMap
此參數僅適用於內部部署 Exchange。
CreateDTMFMap 參數會指定是否要為收件者建立雙色調多頻率 (DTMF) 對應。 這可讓您在整合通訊 (UM) 環境中使用電話按鍵來識別收件者。 有效值為:
- $true:會為收件者建立 DTMF 對應。 這是預設值。
- $true:為收件者建立 DTMF 對應。此為預設值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Department
Department 參數會指定使用者的部門。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DesiredWorkloads
此參數只能在雲端式服務中使用。
{{ 填入 DesiredWorkloads 描述 }}
Type: | Microsoft.Exchange.Data.MailboxWorkloadFlags |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-DisplayName
DisplayName 參數會指定使用者的顯示名稱。 顯示名稱會顯示在 Exchange 系統管理中心和 Active Directory 中。 最大長度為 256 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Fax
Fax 參數會指定使用者的傳真號碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FirstName
FirstName 參數可指定使用者的名字。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Force
此參數只能在雲端式服務中使用。
Force 參數會隱藏警告或確認訊息。 您不需要使用此參數指定值。
在不適合提示系統管理員輸入的場合中,您可以使用此參數來利用程式設計方式執行工作。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-GeoCoordinates
GeoCoordinates 參數會指定使用者在緯度、經度和 (選擇性地) 高度座標的位置。 此參數的有效值會使用下列其中一種格式:
- 緯度和經度:例如,「47.644125;-122.122411」
- 緯度、經度和高度:例如,「47.644125;-122.122411;161.432」
注意:如果期間分隔符號不適用於您,請改用逗號。
Type: | GeoCoordinates |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-HomePhone
HomePhone 參數會指定使用者的住家電話號碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Identity
Identity 參數會指定您要修改的使用者。 您可以使用唯一識別使用者的任何值。 例如:
- 名稱
- 使用者主要名稱 (UPN)
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- GUID
- UserPrincipalName
Type: | UserIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
此參數僅適用於內部部署 Exchange。
IgnoreDefaultScope 參數會指示命令忽略 Exchange PowerShell 會話的預設收件者範圍設定,並使用整個樹系作為範圍。 您不需要使用此參數指定值。
此參數可讓 命令存取預設範圍中目前無法使用的 Active Directory 物件,但也引進下列限制:
- 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
- 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Initials
Initials 參數會指定使用者的中間名縮寫。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-LastName
LastName 參數可指定使用者的姓氏。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-LinkedCredential
此參數僅適用於內部部署 Exchange。
LinkedCredential 參數會指定用來存取 LinkedDomainController 參數所指定網域控制站的使用者名稱和密碼。
此參數的值需要使用 Get-Credential Cmdlet。 若要暫停此命令並收到輸入認證的提示,請使用值 (Get-Credential)
。 或者,在您執行此命令之前,將認證儲存在變數中 (例如,$cred = Get-Credential
),然後將變數名稱 ($cred
) 用於此參數。 如需詳細資訊,請參閱 Get-Credential。
LinkedCredential 參數只能與連結的使用者搭配使用。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LinkedDomainController
此參數僅適用於內部部署 Exchange。
如果此使用者是連結的使用者,則 LinkedDomainController 參數會指定使用者帳戶所在之樹系中的網域控制站。 使用者帳戶所在樹系中的網域控制站是用來取得 LinkedMasterAccount 參數會指定之帳戶的安全性資訊。
僅當您要連接連結的使用者時,才需要此參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LinkedMasterAccount
此參數僅適用於內部部署 Exchange。
如果此使用者是連結的使用者,則 LinkedMasterAccount 參數會指定使用者帳戶所在之樹系中的主帳戶。 主帳戶是使用者連結到的帳戶。 主帳戶會授與使用者的存取權限。 您可以使用下列其中一個值:
- GUID
- Dn
- Domain\Account
- UPN
- LegacyExchangeDN
- SmtpAddress
- 別名
- $null
如果將此參數的值設為 $null,您將會取消連結帳戶,並將連結的信箱轉換到未連結的使用者信箱。 此信箱將不會保留先前所設定的權限,例如「傳送為」、完整存取、資料夾和行事曆委派。
僅當您要連接連結的使用者時,才需要此參數。
Type: | UserIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxRegion
此參數只能在雲端式服務中使用。
{{ 填入 MailboxRegion 描述 }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MailboxRegionSuffix
此參數只能在雲端式服務中使用。
{{ 填入 MailboxRegionSuffix Description }}
Type: | MailboxRegionSuffixValue |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Manager
Manager 參數會指定使用者的管理員。
Type: | UserContactIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MobilePhone
MobilePhone 參數會指定使用者的主要行動電話號碼。
注意:在Exchange Online中,您無法使用此參數。 請改用 Microsoft Graph PowerShell 中 Update-MgUser Cmdlet 上的 MobilePhone 參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
Name 參數會指定使用者的唯一名稱。 最大長度為 64 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Notes
Notes 參數會指定有關物件的額外資訊。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Office
Office 參數會指定使用者的實際辦公室名稱或號碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherFax
OtherFax 參數會指定使用者的替代傳真號碼。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherHomePhone
OtherHomePhone 參數會指定使用者的替代住家電話號碼。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherTelephone
OtherTelephone 參數會定義使用者的替代電話號碼。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Pager
Pager 參數會指定使用者的呼叫器號碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PermanentlyClearPreviousMailboxInfo
此參數在內部部署 Exchange 中無法使用或無法運作。 它只能在Exchange Online中使用。
PermanentlyClearPreviousMailboxInfo 參數會指定是否要清除使用者的Exchange Online信箱屬性。 您不需要使用此參數指定值。
在內部部署 Exchange 與 Microsoft 365 之間的信箱移動和重新授權案例中,可能需要清除這些屬性。 如需詳細資訊,請參閱 永久清除先前的信箱資訊。
注意:此參數會永久刪除現有的雲端信箱及其相關聯的封存、防止您重新連線至信箱,並防止您從信箱復原內容。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Phone
Phone 參數會指定使用者的辦公室電話號碼。
注意:在Exchange Online中,您無法使用此參數。 請改用 Microsoft Graph PowerShell 中 Update-MgUser Cmdlet 上的 BusinessPhones 參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PhoneticDisplayName
PhoneticDisplayName 參數指定使用者姓名的替代拼字,其用於整合通訊 (UM) 環境中的文字轉換語音。 一般而言,當使用者姓名的發音和拼字不符時,您需要使用此參數。 最大長度為 256 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PostalCode
PostalCode 參數會指定使用者的郵遞區號。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PostOfficeBox
PostOfficeBox 參數會指定使用者的郵政信箱號碼。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PublicFolder
需要 PublicFolder 參數才能修改公用資料夾信箱。 您不需要使用此參數指定值。
公用資料夾信箱專為儲存公用資料夾階層與內容設計的信箱。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RemotePowerShellEnabled
RemotePowerShellEnabled 參數會指定使用者是否具有遠端 PowerShell 的存取權。 即使您嘗試在本機信箱伺服器上開啟 Exchange 管理命令介面或 EAC,仍需要遠端 PowerShell 存取,才能開啟 Exchange 管理命令介面或 Exchange 系統管理中心 (EAC) 。 有效值為:
- $true:使用者可以存取遠端 PowerShell。
- $false:使用者無法存取遠端 PowerShell。
預設值取決於指派給使用者的管理角色。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RemoveMailboxProvisioningConstraint
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ResetPasswordOnNextLogon
ResetPasswordOnNextLogon 參數會指定使用者下次登入時是否必須變更其密碼。 有效值為:
- $true:使用者必須在下次登入時變更其密碼。
- $false:使用者不需要在下次登入時變更密碼。 這是預設值。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SamAccountName
此參數僅適用於內部部署 Exchange。
SamAccountName 參數 (也就是 Windows 2000 之前的使用者帳戶或群組名稱) 會指定與舊版 Microsoft Windows 用戶端和伺服器作業系統相容的物件識別碼。 值可以包含字母、數位、空格、句號 (.) ,以及下列字元:!、#、$、% 、^、、 & -、_、{、}和 ~。 最後一個字元不能是句點。 允許使用 Unicode 字元,不過加上重音的字元可能會產生衝突 (例如,o 和 ö 對比)。 最大長度為 20 個字元。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SeniorityIndex
SeniorityIndex 參數會指定這個使用者將在階層式通訊錄中顯示的順序。 值為 2 的使用者在通訊錄中顯示的位置比值為 1 的使用者高。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SimpleDisplayName
如果只允許一組有限的字元,則會使用 SimpleDisplayName 參數來顯示物件的替代描述。 有效字元為:
- SimpleDisplayName 參數是在只允許有限的一組字元時,用來顯示物件的替代性描述。有效的字元為:
- a - z
- A - Z
- 空格
" ' ( ) + , - . / : ?
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SkipDualWrite
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-StateOrProvince
StateOrProvince 參數會指定使用者所在的州或省。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-StreetAddress
StreetAddress 參數會指定使用者的實際地址。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-StsRefreshTokensValidFrom
此參數只能在雲端式服務中使用。
StsRefreshTokensValidFrom 會指定使用者的 STS 重新整理權杖有效來源的日期時間。
在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 mm/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-TelephoneAssistant
此參數僅適用於內部部署 Exchange。
TelephoneAssistant 參數會指定使用者助理員的電話號碼。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Title
Title 參數會指定使用者的職稱。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UMCallingLineIds
此參數僅適用於內部部署 Exchange。
UMCallingLineIds 參數會指定可對應至已啟用整合通訊 (UM) 之使用者的電話號碼或分機。 您可以為每個使用者指定多個電話號碼,並以逗號分隔。 這個參數接受長度小於 128 個字元的數字,而且可在數字的前面包含一個選用加號 (+)。 每個已啟用 UM 的使用者都必須擁有唯一的 UMCallingLineIds 參數值。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UMDtmfMap
此參數僅適用於內部部署 Exchange。
UMDtmfMap 參數會為收件者指定雙調多頻率 (DTMF) 對應值。 這可讓您在整合通訊 (UM) 環境中使用電話按鍵來識別收件者。 這些 DTMF 值通常會自動建立和更新,但您可以使用此參數手動進行變更。 此參數使用下列語法:
emailAddress:<integers>
lastNameFirstName:<integers>
firstNameLastName:<integers>
若要輸入覆寫所有現有專案的值,請使用下列語法: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>
。
如果您使用此語法並省略任何 DTMF 對應值,則會從收件者中移除這些值。 例如,如果您只 emailAddress:<integers>
指定 ,則會移除所有現有的 lastNameFirstName 和 firstNameLastName 值。
若要新增或移除值而不影響其他現有的專案,請使用下列語法: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}
。
如果您使用此語法,則不需要指定所有 DTMF 對應值,而且可以指定多個 DTMF 對應值。 例如,您可以使用 @{Add="emailAddress:<integers1>","emailAddress:<integers2>}
來新增 emailAddress 的兩個新值,而不會影響現有的 lastNameFirstName 和 firstNameLastName 值。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UserPrincipalName
此參數僅適用於內部部署 Exchange。
UserPrincipalName 參數會指定使用者帳戶的登入名稱。 UPN 使用電子郵件地址格式: username@domain
。 一般而言,網域值是使用者帳戶所在的網域。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-VIP
此參數只能在雲端式服務中使用。
VIP 參數會指定使用者是否為優先帳戶。 有效值為:
- $true:使用者是優先帳戶。
- $false:使用者不是優先帳戶。
如需優先順序帳戶的詳細資訊,請 參閱管理和監視優先順序帳戶。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-WebPage
WebPage 參數會指定使用者的網頁。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf 參數無法在此 Cmdlet 上運作。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WindowsEmailAddress
WindowsEmailAddress 參數會指定此收件者的 Windows 電子郵件地址。 這是存在於所有環境中的常見 Active Directory 屬性,包括沒有 Exchange 的環境。 在收件者上使用 WindowsEmailAddress 參數有下列其中一個結果:
- 在收件者受限於電子郵件地址原則 (EmailAddressPolicyEnabled 屬性設定為收件者) 的 True 值時,WindowsEmailAddress 參數不會影響 WindowsEmailAddress 屬性或主要電子郵件地址值。
- 在收件者不受電子郵件地址原則約束的環境中 (EmailAddressPolicyEnabled 屬性會設定為收件者) 的 False 值,WindowsEmailAddress 參數會將 WindowsEmailAddress 屬性和主要電子郵件地址更新為相同的值。
WindowsEmailAddress 屬性在 [Active Directory 使用者和電腦] 的 [電子郵件] 屬性中會顯示收件者。 屬性一般名稱是 E-mail-Addresses,而 Ldap-Display-Name 是 mail。 如果您在 Active Directory 中修改此屬性,收件者的主要電子郵件地址不會更新為相同的值。
Type: | SmtpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。