Set-PartnerApplication

模組:: Exchange PowerShell

此指令本僅能在本地 Exchange 中運作。

使用 Set-PartnerApplication cmdlet 來配置本地 Exchange 組織中的合作夥伴應用程式配置。

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

語法

ACSTrustApplication

Set-PartnerApplication
    [-Identity] <PartnerApplicationIdParameter>
    [-ApplicationIdentifier <String>]
    [-Realm <String>]
    [-AcceptSecurityIdentifierInformation <Boolean>]
    [-AccountType <SupportedAccountType>]
    [-ActAsPermissions <String[]>]
    [-AppOnlyPermissions <String[]>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-IssuerIdentifier <String>]
    [-LinkedAccount <UserIdParameter>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

AuthMetadataUrl

Set-PartnerApplication
    [-Identity] <PartnerApplicationIdParameter>
    [-AuthMetadataUrl <String>]
    [-TrustAnySSLCertificate]
    [-AcceptSecurityIdentifierInformation <Boolean>]
    [-AccountType <SupportedAccountType>]
    [-ActAsPermissions <String[]>]
    [-AppOnlyPermissions <String[]>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-IssuerIdentifier <String>]
    [-LinkedAccount <UserIdParameter>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

RefreshAuthMetadata

Set-PartnerApplication
    [-Identity] <PartnerApplicationIdParameter>
    [-RefreshAuthMetadata]
    [-AcceptSecurityIdentifierInformation <Boolean>]
    [-AccountType <SupportedAccountType>]
    [-ActAsPermissions <String[]>]
    [-AppOnlyPermissions <String[]>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-IssuerIdentifier <String>]
    [-LinkedAccount <UserIdParameter>]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

你可以設定合作夥伴應用程式，例如 SharePoint，來存取 Exchange 資源。使用 New-PartnerApplication 指令碼來建立需要存取 Exchange 資源的應用程式的合作夥伴應用程式設定。如需詳細資訊，請參閱規劃 Exchange 2016 整合 SharePoint 與 Skype for Business。我們建議您使用 Configure-EnterprisePartnerApplication.ps1 資料夾中的 %ExchangeInstallPath%Scripts 指令碼以設定協力廠商應用程式。

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

範例

範例 1

Set-PartnerApplication HRApp -RefreshAuthMetadata

本範例將重新整理 HRApp 協力應用程式的驗證中繼資料。

參數

-AcceptSecurityIdentifierInformation

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

AcceptSecurityIdentifierInformation 參數指定 Exchange 是否應接受來自其他受信任 Active Directory 森林的 SI) D 安全識別碼 (合作夥伴應用程式的 SID。根據預設，新的協力應用程式將設定為不自其他樹系接受 SID。若您在信任樹系的部署中，將參數設為 $true。

參數屬性

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

參數集

(All)

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

-AccountType

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

AccountType 參數指定合作夥伴應用程式所需的 Microsoft 帳號類型。有效值為：

OrganizationalAccount：此值為預設值
消費者帳戶

參數屬性

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

參數集

(All)

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

-ActAsPermissions

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

ActAsPermissions 參數指定合作夥伴應用程式允許的代理權限。您可以指定多個以逗號分隔的值。

參數屬性

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

參數集

(All)

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

-ApplicationIdentifier

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

ApplicationIdentifier 參數將為使用驗證伺服器的協力應用程式指定唯一的應用程式識別碼。

參數屬性

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

參數集

ACSTrustApplication

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

-AppOnlyPermissions

適用：Exchange Server 2013

此參數僅在 Exchange Server 2013 中提供。

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

參數屬性

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

參數集

(All)

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

-AuthMetadataUrl

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

AuthMetadataUrl 參數指定 Exchange 可從哪個 URL 取得 AuthMetadata 文件，適用於不使用授權伺服器的合作夥伴應用程式。

參數屬性

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

參數集

AuthMetadataUrl

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

-Confirm

適用：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 參數會引入強迫您認可命令後才繼續作業的暫停。

參數屬性

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

參數集

(All)

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

-DomainController

適用：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

-Enabled

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Enabled 參數會指定是否已啟用協力應用程式。根據預設，新的協力應用程式會啟用。設定參數為 $false 以於停用的狀態下建立應用程式組態。

參數屬性

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

參數集

(All)

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

-Identity

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地信箱內建安全外掛

Identity 參數指定你想修改的合作夥伴應用程式。你可以使用任何能唯一識別合作夥伴應用程式的值。例如：

名稱
ApplicationID (GUID 值)
辨別名稱 (DN)
GUID

參數屬性

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

參數集

(All)

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

-IssuerIdentifier

適用：Exchange Server 2013

此參數僅在 Exchange Server 2013 中提供。

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

參數屬性

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

參數集

(All)

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

-LinkedAccount

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

LinkedAccount 參數指定該應用程式的連結 Active Directory 使用者帳號。 Exchange 在授權用於執行任務的憑證時，會評估連結帳戶的角色基礎存取控制 (RBAC) 權限。

參數屬性

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

參數集

(All)

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

-Name

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Name 參數會指定協力應用程式的新名稱。

參數屬性

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

參數集

(All)

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

-Realm

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

Realm參數會指定協力應用程式的安全領域。如果該代幣來自非被接受的網域，Exchange 會檢查該代幣中指定的網域。在這種情況下，只有在合作夥伴應用程式中指定的相同領域中的令牌才能存取交易所資源。

參數屬性

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

參數集

ACSTrustApplication

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

-RefreshAuthMetadata

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

RefreshAuthMetadata 交換器會從授權伺服器重新整理認證元資料。您不需要使用此參數指定值。

參數屬性

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

參數集

RefreshAuthMetadata

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

-TrustAnySSLCertificate

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

TrustAnySSLCertificate 交換器允許 Exchange 接受來自不受信任的憑證機構 (CA) 的憑證。您不需要使用此參數指定值。

我們不建議在生產環境中使用此開關。

參數屬性

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

參數集

AuthMetadataUrl

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

-WhatIf

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、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

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

意見反應

此頁面對您有幫助嗎？

共用方式為

Set-PartnerApplication

語法

ACSTrustApplication

AuthMetadataUrl

RefreshAuthMetadata

Description

範例

範例 1

參數

-AcceptSecurityIdentifierInformation

參數屬性

參數集

-AccountType

參數屬性

參數集

-ActAsPermissions

參數屬性

參數集

-ApplicationIdentifier

參數屬性

參數集

-AppOnlyPermissions

參數屬性

參數集

-AuthMetadataUrl

參數屬性

參數集

-Confirm

參數屬性

參數集

-DomainController

參數屬性

參數集

-Enabled

參數屬性

參數集

-Identity

參數屬性

參數集

-IssuerIdentifier

參數屬性

參數集

-LinkedAccount

參數屬性

參數集

-Name

參數屬性

參數集

-Realm

參數屬性

參數集

-RefreshAuthMetadata

參數屬性

參數集

-TrustAnySSLCertificate

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

Input types

輸出

Output types

意見反應