共用方式為

Set-User

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Set-User Cmdlet 來修改用戶屬性。 您可以使用此 Cmdlet 來修改具有使用者帳戶的所有物件 (例如，使用者信箱、郵件使用者和使用者帳戶) 。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

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>]
   [-EXOModuleEnabled <Boolean>]
   [-Fax <String>]
   [-FirstName <String>]
   [-Force]
   [-GeoCoordinates <GeoCoordinates>]
   [-HomePhone <String>]
   [-IgnoreDefaultScope]
   [-IsShadowMailbox <Boolean>]
   [-Initials <String>]
   [-LastName <String>]
   [-LinkedCredential <PSCredential>]
   [-LinkedDomainController <String>]
   [-LinkedMasterAccount <UserIdParameter>]
   [-MailboxRegion <String>]
   [-MailboxRegionSuffix <MailboxRegionSuffixValue>]
   [-ManagedOnboardingType <ManagedOnboardingType>]
   [-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 參數會指定是否要從整合通訊目錄搜尋中排除使用者。

類型:AllowUMCallsFromNonUsersFlags
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Arbitration

此參數僅適用於內部部署 Exchange。

需要仲裁參數才能修改仲裁信箱。 您不需要使用此參數指定值。

仲裁信箱是用來儲存不同類型系統數據及管理訊息核准工作流程的系統信箱。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AssistantName

AssistantName 參數會指定使用者助理員的名字。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 或更新版本中的基本身份驗證或 (，) 其他舊版驗證方法。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2019, Exchange Online, Exchange Online Protection

-BlockCloudCache

此參數只能在雲端式服務中使用。

{{ Fill BlockCloudCache Description }}

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-CanHaveCloudCache

此參數只能在雲端式服務中使用。

{{ Fill CanHaveCloudCache Description }}

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-CertificateSubject

此參數僅適用於內部部署 Exchange。

CertificateSubject 參數會指定使用者數位憑證的主旨欄位值。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-City

City 參數會指定使用者所在的城市。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ClearDataEncryptionPolicy

此參數只能在雲端式服務中使用。

{{ Fill ClearDataEncryptionPolicy Description }}

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-Company

Company 參數會指定使用者的公司。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 屬性值中傳回易記名稱，但您可以在篩選作業中使用易記名稱或兩個字母的國家/地區代碼。

類型:CountryInfo
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 對應。此為預設值。
類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Department

Department 參數會指定使用者的部門。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DesiredWorkloads

此參數只能在雲端式服務中使用。

{{ 填入 DesiredWorkloads 描述 }}

類型:Microsoft.Exchange.Data.MailboxWorkloadFlags
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-DisplayName

DisplayName 參數會指定使用者的顯示名稱。 顯示名稱會顯示在 Exchange 系統管理中心和 Active Directory 中。 最大長度為 256 個字元。 如果值包含空格，請使用引號 (") 括住值。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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。

類型:Fqdn
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EXOModuleEnabled

此參數只能在雲端式服務中使用。

EXOModuleEnabled 參數會指定使用者是否可以使用 Exchange Online PowerShell V3 模組連線到 Microsoft 365 組織中的 Exchange Online PowerShell。 有效值為：

  • $true：用戶可以連線到 Exchange Online PowerShell。
  • $false：用戶無法連線到 Exchange Online PowerShell。

預設值取決於指派給使用者的管理角色。

(其他功能也需要存取 Exchange Online PowerShell，例如，在 EAC) ) (開啟 Exchange 系統管理中心的能力。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-Fax

Fax 參數會指定使用者的傳真號碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-FirstName

FirstName 參數可指定使用者的名字。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Force

此參數只能在雲端式服務中使用。

Force 參數會隱藏警告或確認訊息。 您不需要使用此參數指定值。

在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-GeoCoordinates

GeoCoordinates 參數會指定用戶在緯度、經度和 (選擇性地) 高度座標的位置。 此參數的有效值會使用下列其中一種格式：

  • 緯度和經度：例如，“47.644125;-122.122411”
  • 緯度、經度和高度：例如，「47.644125;-122.122411;161.432"

注意：如果期間分隔符不適用於您，請改用逗號。

類型:GeoCoordinates
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-HomePhone

HomePhone 參數會指定使用者的住家電話號碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

Identity 參數會指定您要修改的使用者。 您可以使用唯一識別使用者的任何值。 例如：

  • 名稱
  • 使用者主要名稱 (UPN)
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • GUID
  • UserPrincipalName
類型:UserIdParameter
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False
適用於: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 參數。 此命令會自動使用適當的通用類別目錄伺服器。
類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Initials

Initials 參數會指定使用者的中間名縮寫。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IsShadowMailbox

此參數只能在雲端式服務中使用。

{{ Fill IsShadowMailbox Description }}

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-LastName

LastName 參數可指定使用者的姓氏。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 參數只能與連結的使用者搭配使用。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedDomainController

此參數僅適用於內部部署 Exchange。

如果此使用者是連結的使用者，則 LinkedDomainController 參數會指定使用者帳戶所在之樹系中的網域控制站。 使用者帳戶所在樹系中的網域控制站是用來取得 LinkedMasterAccount 參數會指定之帳戶的安全性資訊。

僅當您要連接連結的使用者時，才需要此參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedMasterAccount

此參數僅適用於內部部署 Exchange。

如果此使用者是連結的使用者，則 LinkedMasterAccount 參數會指定使用者帳戶所在之樹系中的主帳戶。 主帳戶是使用者連結到的帳戶。 主帳戶會授與使用者的存取權限。 您可以使用下列其中一個值：

  • GUID
  • DN
  • Domain\Account
  • UPN
  • LegacyExchangeDN
  • SmtpAddress
  • 別名
  • $null

如果將此參數的值設為 $null，您將會取消連結帳戶，並將連結的信箱轉換到未連結的使用者信箱。 此信箱將不會保留先前所設定的權限，例如「傳送為」、完整存取、資料夾和行事曆委派。

僅當您要連接連結的使用者時，才需要此參數。

類型:UserIdParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MailboxRegion

此參數只能在雲端式服務中使用。

{{ 填入 MailboxRegion 描述 }}

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online

-MailboxRegionSuffix

此參數只能在雲端式服務中使用。

{{ 填入 MailboxRegionSuffix Description }}

類型:MailboxRegionSuffixValue
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online

-ManagedOnboardingType

此參數只能在雲端式服務中使用。

{{ Fill ManagedOnboardingType Description }}

類型:ManagedOnboardingType
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-Manager

Manager 參數會指定使用者的管理員。

類型:UserContactIdParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Name 參數會指定使用者的唯一名稱。 最大長度為 64 個字元。 如果值包含空格，請使用引號 (") 括住值。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Notes

Notes 參數會指定有關物件的額外資訊。 如果值包含空格，請使用引號 (") 括住值。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Office

Office 參數會指定使用者的實際辦公室名稱或號碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherFax

OtherFax 參數會指定使用者的替代傳真號碼。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherHomePhone

OtherHomePhone 參數會指定使用者的替代住家電話號碼。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-OtherTelephone

OtherTelephone 參數會定義使用者的替代電話號碼。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Pager

Pager 參數會指定使用者的呼叫器號碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PermanentlyClearPreviousMailboxInfo

此參數只能在雲端式服務中運作。

PermanentlyClearPreviousMailboxInfo 參數會指定是否要清除使用者的 Exchange Online 信箱屬性。 您不需要使用此參數指定值。

在內部部署 Exchange 與 Microsoft 365 之間的信箱移動和重新授權案例中，可能需要清除這些屬性。 如需詳細資訊，請參閱 永久清除先前的信箱資訊。

注意：此參數可防止您重新連線到信箱，並防止您從信箱復原內容。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Phone

Phone 參數會指定使用者的辦公室電話號碼。

注意：在 Exchange Online 中，您無法使用此參數。 請改用 Microsoft Graph PowerShell 中 Update-MgUser Cmdlet 上的 BusinessPhones 參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PhoneticDisplayName

PhoneticDisplayName 參數指定使用者姓名的替代拼字，其用於整合通訊 (UM) 環境中的文字轉換語音。 一般而言，當使用者姓名的發音和拼字不符時，您需要使用此參數。 最大長度為 256 個字元。 如果值包含空格，請使用引號 (") 括住值。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostalCode

PostalCode 參數會指定使用者的郵遞區號。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PostOfficeBox

PostOfficeBox 參數會指定使用者的郵政信箱號碼。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PublicFolder

需要 PublicFolder 參數才能修改公用資料夾信箱。 您不需要使用此參數指定值。

公用資料夾信箱專為儲存公用資料夾階層與內容設計的信箱。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RemotePowerShellEnabled

注意：在雲端式環境中，此參數已被取代，因此請改用EXOModuleEnabled 參數。

RemotePowerShellEnabled 參數會指定使用者是否可以存取 Exchange PowerShell。 有效值為：

  • $true：使用者可以存取 Exchange Online PowerShell、Exchange 管理命令介面和 Exchange 系統管理中心 (EAC) 。
  • $false：用戶無法存取 Exchange Online PowerShell、Exchange 管理命令介面或 EAC。

預設值取決於指派給使用者的管理角色。

即使您嘗試在本機 Exchange 伺服器上開啟 Exchange 管理命令介面或 EAC，仍需要存取 Exchange PowerShell。

這些管理介面中的使用者體驗仍然受控於指派給它們的角色型存取控制 (RBAC) 權限。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RemoveMailboxProvisioningConstraint

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-ResetPasswordOnNextLogon

ResetPasswordOnNextLogon 參數會指定使用者下次登入時是否必須變更其密碼。 有效值為：

  • $true：用戶必須在下次登入時變更其密碼。
  • $false：使用者不需要在下次登入時變更密碼。 這是預設值。
類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 個字元。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SeniorityIndex

SeniorityIndex 參數會指定這個使用者將在階層式通訊錄中顯示的順序。 值為 2 的使用者在通訊錄中顯示的位置比值為 1 的使用者高。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

如果只允許一組有限的字元，則會使用 SimpleDisplayName 參數來顯示物件的替代描述。 合法字元為：

  • SimpleDisplayName 參數是在只允許有限的一組字元時，用來顯示物件的替代性描述。有效的字元為：
  • a - z
  • A - Z
  • 空格
  • " ' ( ) + , - . / : ?
類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SkipDualWrite

此參數僅適用於內部部署 Exchange。

將保留此參數供 Microsoft 內部使用。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2016, Exchange Server 2019

-StateOrProvince

StateOrProvince 參數會指定使用者所在的州或省。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-StreetAddress

StreetAddress 參數會指定使用者的實際地址。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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"。

類型:DateTime
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-TelephoneAssistant

此參數僅適用於內部部署 Exchange。

TelephoneAssistant 參數會指定使用者助理員的電話號碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Title

Title 參數會指定使用者的職稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UMCallingLineIds

此參數僅適用於內部部署 Exchange。

UMCallingLineIds 參數會指定可對應至已啟用整合通訊 (UM) 之使用者的電話號碼或分機。 您可以為每個使用者指定多個電話號碼，並以逗號分隔。 這個參數接受長度小於 128 個字元的數字，而且可在數字的前面包含一個選用加號 (+)。 每個已啟用 UM 的使用者都必須擁有唯一的 UMCallingLineIds 參數值。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 值。

類型:MultiValuedProperty
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-UserPrincipalName

此參數僅適用於內部部署 Exchange。

UserPrincipalName 參數會指定使用者帳戶的登入名稱。 UPN 使用電子郵件地址格式： username@domain。 一般而言，網域值是用戶帳戶所在的網域。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-VIP

此參數只能在雲端式服務中使用。

VIP 參數會指定使用者是否為優先帳戶。 有效值為：

  • $true：用戶是優先帳戶。
  • $false：使用者不是優先帳戶。

如需優先順序帳戶的詳細資訊，請 參閱管理和監視優先順序帳戶。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Online, Exchange Online Protection

-WebPage

WebPage 參數會指定使用者的網頁。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WhatIf

WhatIf 參數無法在此 Cmdlet 上運作。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於: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 中修改此屬性，收件者的主要電子郵件位址不會更新為相同的值。

類型:SmtpAddress
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False
適用於:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。