共用方式為


Remove-CsCertificate

 

上次修改主題的時間: 2012-03-26

將原先標示為 Microsoft Lync Server 2010 可使用的憑證移除。

語法

Remove-CsCertificate [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]

詳細描述

Lync Server 2010 使用憑證作為一種讓伺服器和伺服器角色確認其身分的方法;例如,Edge Server 會使用憑證確認與其通訊的電腦是否真的是 前端伺服器,反之亦然。若要完整實作 Lync Server,您必須將適當的憑證指派給適當的伺服器角色。

Remove-CsCertificate 指令程式提供方法,讓您移除目前由 Lync Server 使用的憑證。Remove-CsCertificate 不會真的刪除憑證本身,而是將憑證標示為 Lync Server 不可再使用它、移除任何的憑證繫結,以及撤銷對憑證的存取權限 (假設沒有其他服務正在使用此憑證)。除此之外,這表示當您執行 Get-CsCertificate 指令程式時,此憑證將不再出現。

若要讓 Lync Server 再次使用憑證,必須使用 Set-CsCertificate 指令程式,為 Lync Server 2010 重新指派憑證。

如果您嘗試移除目前使用中的憑證,Remove-CsCertificate 將詢問您是否確定要移除該憑證;在您回應該提示之前,無法移除該憑證。若要略過此提示,即使目前正在使用的憑證也要以無訊息方式加以刪除,請在命令中加上 Force 參數:

Remove-CsCertificate –Type WebServicesExternal -Force

誰可以執行這個指令程式:您必須是本機系統管理員和網域的成員,才能本機執行 Remove-CsCertificate 指令程式。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCertificate"}

參數

參數 必要 類型 描述

Type

選用

字串

要刪除的憑證類型。憑證類型包括 (但不限於):

AccessEdgeExternal

AudioVideoAuthentication

DataEdgeExternal

Default

External

Internal

PICWebService (僅限 Microsoft Lync Online 2010)

ProvisionService (僅限 Microsoft Lync Online 2010)

WebServicesExternal

WebServicesInternal

WsFedTokenTransfer

例如,下列語法會刪除 Default 憑證:-Type Default。

您可以在單一命令中,利用逗號分隔憑證類型的方式來刪除多個類型:

-Type Internal,External,Default

NetportId

選用

字串

保留供未來使用。此參數用於專門用於特定連接埠的憑證,Lync Server 尚未支援此案例。

Force

選用

切換參數

如果您嘗試刪除目前使用中的憑證,通常會產生略過確認提示的情況。

Report

選用

字串

讓您可以記錄 Remove-CsCertificate 執行的程序的詳細資訊。其參數值應該是即將產生之 HTML 檔的完整路徑,如:-Report C:\Logs\Certificates.html。如果指定的檔案已經存在,將會自動以新資訊覆寫該檔案。

WhatIf

選用

切換參數

描述執行命令後的結果,但無須實際執行命令。

Confirm

選用

切換參數

執行命令前先要求您確認。

輸入類型

無。Remove-CsCertificate 不會接受管線傳送的輸入。

傳回類型

無。而 Remove-CsCertificate 會刪除 Microsoft.Rtc.Management.Deployment.CertificateReference 物件的執行個體。

範例

-------------------------- 範例 1 ------------------------

Remove-CsCertificate -Type WebServicesExternal

範例 1 所示的命令會刪除可供 Lync Server 使用的所有 WebServicesExternal 憑證。如果目前正在使用任何的這類憑證,Remove-CsCertificate 將詢問您是否確定要移除該憑證;您必須先回應該提示,命令才能完成。若要略過確認提示,請使用 Force 參數:

Remove-CsCertificate –Type WebServicesExternal -Force