Set-User

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。

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

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

Default (預設值)

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 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 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

本範例將 LinkedMasterAccount 參數設定為 $null,以取消連結連結信箱 Kweku@fabrikam.com 並將其轉換成使用者信箱。

在連結的信箱上執行這個程序會移除信箱的所有權限,例如「傳送為」、「完整存取」、「資料夾」和「行事曆委派」。

參數

-AllowUMCallsFromNonUsers

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

AllowUMCallsFromNonUsers 參數會指定是否要將使用者從整合通訊目錄搜尋中排除。

參數屬性

類型:AllowUMCallsFromNonUsersFlags
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Arbitration

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AssistantName

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-AuthenticationPolicy

適用項目:Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件

AuthenticationPolicy 參數會指定要套用至使用者的驗證原則。 您可以使用唯一識別原則的任何值。 例如:

  • 名稱
  • 辨別名稱 (DN)
  • GUID

若要移除使用者的原則指派,請使用值 $null。

您可以使用 New-AuthenticationPolicy Cmdlet 建立驗證原則,以封鎖或選擇性地允許 Exchange 2019 CU2 或更新版本) 其他舊版驗證方法中的基本驗證或 (。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-BlockCloudCache

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

{{ 填滿 BlockCloudCache 描述 }}

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CanHaveCloudCache

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

{{ Fill CanHaveCloudCache 描述 }}

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CertificateSubject

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-City

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ClearDataEncryptionPolicy

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

{{ Fill ClearDataEncryptionPolicy 描述 }}

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Company

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet,指定不帶值的 Confirm 參數會造成暫停,強制您在繼續之前先確認命令。

此 Cmdlet 具有內建的暫停,因此請使用 -Confirm:$false 來略過確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:CF

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CountryOrRegion

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

CountryOrRegion 參數會指定使用者所在的國家或地區。 有效的值是有效的 ISO 3166-1 雙字母國家/地區代碼 (例如,澳大利亞) 的 AU 或國家/地區 (的對應易記名稱,這可能與官方的 ISO 3166 維護機構簡寫名稱) 不同。

國家 /地區代碼清單中提供了兩個字母國家/地區代碼的參考。

易記名稱是由 Get-User Cmdlet 在 CountryOrRegion 屬性值中傳回,但您可以在篩選作業中使用易記名稱或兩個字母的國家/地區代碼。

參數屬性

類型:CountryInfo
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-CreateDTMFMap

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

CreateDTMFMap 參數會指定是否要為收件者建立雙音多頻 (DTMF) 對應。 這可讓在整合通訊 (UM) 環境中,使用電話鍵盤來識別收件者。 有效值為:

  • $true:已為收件者建立 DTMF 對應。 此值為預設值。
  • $true:為收件者建立 DTMF 對應。此為預設值。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Department

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DesiredWorkloads

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

{{ Fill DesiredWorkloads 描述 }}

參數屬性

類型:Microsoft.Exchange.Data.MailboxWorkloadFlags
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DisplayName

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EXOModuleEnabled

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

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

  • $true:使用者可以連線到Exchange Online PowerShell。
  • $false:使用者無法連線到 Exchange Online PowerShell。

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

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

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Fax

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FirstName

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Force

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-GeoCoordinates

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件

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

  • 緯度和經度:例如 “47.644125;-122.122411”
  • 緯度、經度和高度:例如,“47.644125;-122.122411;161.432"

注意:如果句號分隔符號不起作用,請改用逗號。

參數屬性

類型:GeoCoordinates
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-HomePhone

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

  • 名稱
  • 使用者主要名稱 (UPN)
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • GUID
  • UserPrincipalName

參數屬性

類型:UserIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-IgnoreDefaultScope

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

IgnoreDefaultScope 參數會告知命令忽略 Exchange PowerShell 工作階段的預設收件者範圍設定,並使用整個樹系作為範圍。 您不需要使用此參數指定值。

此參數可讓命令存取預設範圍中目前不可用的 Active Directory 物件,但也會引進下列限制:

  • 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。
  • 您不能使用 DomainController 參數。 此命令會自動使用適當的通用類別目錄伺服器。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Initials

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IsShadowMailbox

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

{{ Fill IsShadowMailbox 描述 }}

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-LastName

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-LinkedCredential

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

LinkedCredential 參數會指定用來存取 LinkedDomainController 參數所指定網域控制站的使用者名稱和密碼。

此參數的值需要使用 Get-Credential Cmdlet。 若要暫停此命令並收到輸入認證的提示,請使用值 (Get-Credential)。 或者,在您執行此命令之前,將認證儲存在變數中 (例如,$cred = Get-Credential),然後將變數名稱 ($cred) 用於此參數。 如需詳細資訊,請參閱 Get-Credential

LinkedCredential 參數只能與連結的使用者搭配使用。

參數屬性

類型:PSCredential
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-LinkedDomainController

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-LinkedMasterAccount

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

  • GUID
  • DN
  • 網域\帳戶
  • UPN
  • LegacyExchangeDN
  • SmtpAddress
  • 別名
  • $null

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

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

參數屬性

類型:UserIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MailboxRegion

適用:Exchange Online

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

{{ Fill MailboxRegion 描述 }}

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MailboxRegionSuffix

適用:Exchange Online

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

{{ Fill MailboxRegionSuffix description }}

參數屬性

類型:MailboxRegionSuffixValue
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ManagedOnboardingType

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

{{ 填入 ManagedOnboardingType 說明 }}

參數屬性

類型:ManagedOnboardingType
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Manager

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:UserContactIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MobilePhone

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

MobilePhone 參數會指定使用者的主要行動電話號碼。

在 Exchange Online 中,您也可以在 Microsoft Graph PowerShell 中的 Update-MgUser Cmdlet 上使用 MobilePhone 參數。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Notes

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Office

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OtherFax

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OtherHomePhone

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-OtherTelephone

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Pager

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PermanentlyClearPreviousMailboxInfo

適用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

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

警告:此參數會防止您重新連線到信箱,並防止您從信箱復原內容。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Phone

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

在 Exchange Online 中,您也可以在 Microsoft Graph PowerShell 的 Update-MgUser Cmdlet 上使用 BusinessPhones 參數。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PhoneticDisplayName

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PostalCode

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PostOfficeBox

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PublicFolder

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署信箱的內建安全性附加元件

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RemotePowerShellEnabled

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

注意:在雲端式環境中,此參數將被取代。 建議您改為使用 EXOModuleEnabled 參數。

RemotePowerShellEnabled 參數會指定使用者是否具有 Exchange PowerShell 的存取權限。 有效值為:

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

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

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

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

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RemoveMailboxProvisioningConstraint

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResetPasswordOnNextLogon

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

  • $true:使用者下次登入時必須變更密碼。
  • $false:使用者下次登入時不需要變更密碼。 此值為預設值。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SamAccountName

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

SamAccountName 參數 (也就是 Windows 2000 之前的使用者帳戶或群組名稱) 會指定與舊版 Microsoft Windows 用戶端和伺服器作業系統相容的物件識別碼。 該值可以包含字母、數字、空格、句點 (.) ,以及下列字元:!、#、$、%、^、&、-、_、{、} 和 ~。 最後一個字元不能是句點。 允許使用 Unicode 字元,但重音字元可能會產生衝突 (,例如,o 和 ö 符合) 。 最大長度為 20 個字元。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SeniorityIndex

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SimpleDisplayName

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

SimpleDisplayName 參數可用來在只允許一組有限的字元時顯示物件的替代描述。 有效字元為:

  • SimpleDisplayName 參數是在只允許有限的一組字元時,用來顯示物件的替代性描述。有效的字元為:
  • a - z
  • A - Z
  • 空格
  • " ' ( ) + , - . / : ?

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SkipDualWrite

適用項目:Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StateOrProvince

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StreetAddress

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-StsRefreshTokensValidFrom

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

StsRefreshTokensValidFrom 會指定使用者的 STS 重新整理權杖有效的日期時間。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定為使用簡短的日期格式 MM/dd/yyyy,請輸入 09/01/2018 以指定 2018 年 9 月 1 日。 您可以只輸入日期,或者也可以輸入日期和時間。 如果輸入日期和時間,請使用引號 (") 括住值,例如 "09/01/2018 5:00 PM"。

參數屬性

類型:DateTime
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TelephoneAssistant

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Title

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-UMCallingLineIds

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-UMDtmfMap

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 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
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-UserPrincipalName

適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-VIP

適用:Exchange Online、內部部署信箱的內建安全性附加元件

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

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

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

如需優先帳戶的詳細資訊,請參閱 管理和監視優先帳戶

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WebPage

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:WI

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WindowsEmailAddress

適用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

WindowsEmailAddress 參數會指定此收件者的 Windows 電子郵件地址。 這是所有環境中都存在的常見 Active Directory 屬性,包括沒有 Exchange 的環境。 對收件者使用 WindowsEmailAddress 參數會產生下列其中一個結果:

  • 在收件者受電子郵件地址原則約束的環境中, (EmailAddressPolicyEnabled 屬性設定為收件者) 的值 True,則 WindowsEmailAddress 參數對 WindowsEmailAddress 屬性或主要電子郵件地址值沒有影響。
  • 在收件者不受電子郵件地址原則約束的環境中, (EmailAddressPolicyEnabled 屬性設定為收件者) 的值 False,WindowsEmailAddress 參數會將 WindowsEmailAddress 屬性和主要電子郵件地址更新為相同的值。

WindowsEmailAddress 屬性可在 Active Directory 使用者和電腦的電子郵件屬性中對收件者可見。 屬性公用名稱是 E-mail-Addresses,而 Ldap-Display-Name 是郵件。 如果您在 Active Directory 中修改此屬性,收件者的主要電子郵件地址不會更新為相同值。

參數屬性

類型:SmtpAddress
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

Input types

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

輸出

Output types

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