Disable-CmdletExtensionAgent

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

內部部署 Exchange 才有提供此 Cmdlet。

使用 Disable-CmdletExtensionAgent Cmdlet 停用現有的 Cmdlet 擴充代理程式。

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

Syntax

Disable-CmdletExtensionAgent
       [-Identity] <CmdletExtensionAgentIdParameter>
       [-Confirm]
       [-DomainController <Fqdn>]
       [-WhatIf]
       [<CommonParameters>]

Description

Exchange Server 2010 和更新版本中的 Exchange Cmdlet 會使用 Cmdlet 擴充代理程式。 其他Microsoft或協力廠商產品提供的 Cmdlet 無法使用 Cmdlet 擴充代理程式。

當您停用 Cmdlet 擴充代理程式時，會停用整個組織的代理程式。 When an agent is disabled, it's not made available to cmdlets. Cmdlets can no longer use the agent to perform additional operations.

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Disable-CmdletExtensionAgent "Scripting Agent"

此範例會停用名為 Scripting Agent 的 Cmdlet 延伸模組代理程式。

參數

-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

-DomainController

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

-Identity

Identity 參數會指定您要停用的已啟用 Cmdlet 擴充代理程式。 您可以使用唯一識別代理程式的任何值。 例如：

  • 名稱
  • 辨別名稱 (DN)
  • GUID
Type:CmdletExtensionAgentIdParameter
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

-WhatIf

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

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

輸入

Input types

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

輸出

Output types

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