Set-CsCertificate
上次修改主題的時間： 2012-03-26
可讓您將憑證指派給 Microsoft Lync Server 2010 伺服器或伺服器角色。
語法
Set-CsCertificate -Reference <CertificateReference> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]
Set-CsCertificate -Thumbprint <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetportId <String>] [-Report <String>] [-Type <CertType[]>] [-WhatIf [<SwitchParameter>]]
詳細描述
Lync Server 2010 使用憑證作為一種讓伺服器和伺服器角色確認其身分的方法；例如，Edge Server 會使用憑證確認與其通訊的電腦是否真的是 前端伺服器，反之亦然。若要完整實作 Lync Server，您必須將適當的憑證指派給適當的伺服器角色。
Set-CsCertificate 指令程式可讓系統管理員將憑證指派給伺服器或伺服器角色。請注意，您只能指派已設定為搭配 Lync Server 使用的憑證。若要識別可用於指派的憑證，請使用 Get-CsCertificate 指令程式。
誰可以執行這個指令程式：您必須是本機系統管理員，才能在本機執行 Set-CsCertificate 指令程式。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCertificate"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
NetportId |
選用 |
字串 |
保留供日後使用。此參數是供專用於特定連接埠的憑證使用，Lync Server 尚不支援此案例。 |
Reference |
選用 |
CertificateReference 物件 |
設定為搭配 Lync Server 使用之憑證的物件參考。下列命令會傳回代表指紋為 B142918E463981A76503828BB1278391B716280987B 之憑證的物件參照 (變數 $x)： $x = Get-CsCertificate | Where-Object {$_.Thumbprint –eq "B142918E463981A76503828BB1278391B716280987B"。 |
Thumbprint |
選用 |
字串 |
憑證的唯一識別碼。憑證指紋外觀類似如下：B142918E463981A76503828BB1278391B716280987B。 |
Type |
選用 |
字串 |
指派的憑證類型。憑證類型包含 (但不限於) 下列類型： AccessEdgeExternal AudioVideoAuthentication DataEdgeExternal Default External Internal iPhoneAPNService iPadAPNService MPNService PICWebService (僅限 Microsoft Lync Online 2010) ProvisionService (僅限 Microsoft Lync Online 2010) WebServicesExternal WebServicesInternal WsFedTokenTransfer 例如，此語法會指派 Default 認證：-Type Default。 您可以在單一命令中以逗號隔開憑證類型，以指定多種類型： -Type Internal,External,Default |
Force |
選用 |
切換參數 |
抑制顯示執行命令時可能引起的任何非嚴重錯誤訊息。 |
Report |
選用 |
字串 |
可讓您記錄關於由 Set-CsCertificate 執行之程序的詳細資訊。此參數值應該是要產生之 HTML 檔案的完整路徑；例如：-Report C:\Logs\Certificates.html。如果指定的檔案已經存在，將會自動以新資訊覆寫該檔案。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.Deployment.CertificateReference。
傳回類型
Set-CsCertificate 不會傳回任何值或物件，
範例
-------------------------- 範例 1 ------------------------
Set-CsCertificate -Type WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"
範例 1 所示的命令會將 Thumbprint 為 B142918E463981A76503828BB1278391B716280987B 的憑證指派給本機電腦上的 WebServicesExternal 角色。
-------------------------- 範例 2 ------------------------
Set-CsCertificate -Type Default, WebServicesInternal, WebServicesExternal -Thumbprint "B142918E463981A76503828BB1278391B716280987B"
以上的命令會將 Thumbprint 為 B142918E463981A76503828BB1278391B716280987B 的憑證指派給本機電腦上三個不同的角色：Default、WebServicesInternal 以及 WebServicesExternal。