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