共用方式為


Set-OnPremisesOrganization

此指令程式只能在雲端式服務中使用。

使用 Set-OnPremisesOrganization 指令檔修改 Microsoft 365 租戶中 OnPremisesOrganization 物件的參數。

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

語法

Default (預設值)

Set-OnPremisesOrganization
    [-Identity] <OnPremisesOrganizationIdParameter>
    [-Comment <String>]
    [-Confirm]
    [-HybridDomains <MultiValuedProperty>]
    [-InboundConnector <InboundConnectorIdParameter>]
    [-OrganizationName <String>]
    [-OrganizationRelationship <OrganizationRelationshipIdParameter>]
    [-OutboundConnector <OutboundConnectorIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Description

OnPremisesOrganization 物件代表一個本地 Exchange 組織,並配置為與 Microsoft 365 組織的混合部署。 通常,這個物件只會由混合組態精靈修改和更新。 手動修改此物件可能導致混合部署配置錯誤;因此,我們強烈建議您使用混合組態精靈來更新 Microsoft 365 組織中的此物件。

您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

Set-OnPremisesOrganization -Identity "ExchangeMail" -HybridDomains contoso.com, sales.contoso.com, legal.contoso.com

此範例為 Microsoft 365 組織的 ExchangeMail OnPremisesOrganization 物件新增第三個網域 legal.contoso.com,該物件已擁有 contoso.com 與 sales.contoso.com 網域。

參數

-Comment

適用:Exchange Online

Comment 參數會指定選擇性註解。 如果指定的值含有空格,則必須以雙引號 (") 括住值,例如︰"This is an admin note"。

參數屬性

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

參數集

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

-Confirm

適用:Exchange Online,內建本地信箱安全外掛

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

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

參數屬性

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

參數集

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

-HybridDomains

適用:Exchange Online

HybridDomains 參數指定在 Microsoft 365 組織與本地 Exchange 組織之間混合部署時所設定的網域。 此參數中指定的網域必須與混合配置 Active Directory 物件中由混合配置精靈設定的本地 Exchange 組織所列出的網域相符。 多個網域可能會被列出,且必須以逗號分隔,例如「contoso.com, sales.contoso.com」。

參數屬性

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

參數集

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

-Identity

適用:Exchange Online,內建本地信箱安全外掛

Identity 參數指定了本地組織物件的身份。 您可以使用下列值:

  • 正式名稱
  • GUID
  • 名稱

參數屬性

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

參數集

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

-InboundConnector

適用:Exchange Online

InboundConnector 參數指定在 Microsoft 365 中為混合部署設定的入站連接器名稱,該部署與本地 Exchange 組織進行配置。

參數屬性

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

參數集

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

-OrganizationName

適用:Exchange Online

OrganizationName 參數指定本地 Exchange 組織的 Active Directory 物件名稱。

參數屬性

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

參數集

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

-OrganizationRelationship

適用:Exchange Online

OrganizationRelationship 參數指定了 Microsoft 365 組織中混合組態精靈所設定的組織關係,作為與本地 Exchange 組織混合部署的一部分。 這種組織關係定義了 Microsoft 365 組織所啟用的聯邦共享功能。

參數屬性

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

參數集

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

-OutboundConnector

適用:Exchange Online

OutboundConnector 參數指定了在 Microsoft 365 中為與本地 Exchange 組織進行混合部署所設定的外站連接器名稱。

參數屬性

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

參數集

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

-WhatIf

適用:Exchange Online,內建本地信箱安全外掛

WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值: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

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