Remove-CsTrustedApplicationEndpoint
上次修改主題的時間: 2012-03-26
移除受信任的應用程式端點。
語法
Remove-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
詳細描述
信任的應用程式端點是 Active Directory 連絡人物件,可讓呼叫路由傳送至信任的應用程式。此指令程式移除 Active Directory 網域服務 (AD DS) 中現有的端點連絡人物件。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsTrustedApplicationEndpoint Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplicationEndpoint"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
UserIdParameter |
要移除之應用程式端點的 Identity (連絡人的辨別名稱)、SIP 位址或顯示名稱。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 物件。接受管線傳送的受信任應用程式端點物件輸入。
傳回類型
這個指令程式不會傳回值。它會移除 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Remove-CsTrustedApplicationEndpoint -Identity "Endpoint 1"
此範例會移除 Identity (在此案例中為顯示名稱) 為 Endpoint 1 的端點連絡人。由於 Identity 必須是唯一的,因此這個命令最多只會移除一個端點。
-------------------------- 範例 2 ------------------------
Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Remove-CsTrustedApplicationEndpoint
這個範例會移除所有和應用程式 tapp2 相關聯的受信任應用程式端點。完成這項作業的方法為先呼叫 Get-CsTrustedApplicationEndpoint,然後再將 ID tapp2 傳遞至 ApplicationId 參數。如此可傳回和 tapp2 受信任應用程式相關聯的端點集合。然後將這個集合傳送到 Remove-CsTrustedApplicationEndpoint 指令程式,由其移除集合中的每個端點。請記住,這個對 Get-CsTrustedApplicationEndpoint 的呼叫會從多重集區擷取應用程式 ID 為 tapp2 的端點,其會產生此命令,並從多重集區中移除信任的應用程式端點。