Get-CsCertificate
上次修改主題的時間： 2012-03-23
傳回已設定為搭配 Microsoft Lync Server 2010 使用之本機電腦上的憑證相關資訊。
語法
Get-CsCertificate [-NetportId <String>] [-Report <String>] [-Type <CertType[]>]
詳細描述
Lync Server 2010 使用憑證作為一種讓伺服器和伺服器角色確認其身分的方法；例如，Edge Server 會使用憑證確認與其通訊的電腦是否真的是 前端伺服器，反之亦然。若要完整實作 Lync Server，您必須將適當的憑證指派給適當的伺服器角色。
Get-CsCertificate 指令程式提供一種方式，讓您擷取關於已設定為搭配 Lync Server 使用之憑證的詳細資訊。請注意，此指令程式只會傳回關於 Lync Server 憑證的資訊。如果憑證未設定為用於 Lync Server (使用 Set-CsCertificate 指令程式)，則當您執行 Get-CsCertificate 時，不會傳回該憑證。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsCertificate Cmdlet：RTCUniversalServerAdmins。
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
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 |
NetportId |
選用 |
字串 |
保留供日後使用。此參數是供專用於特定連接埠的憑證使用，Lync Server 尚不支援此案例。 |
Report |
選用 |
字串 |
可讓您記錄由 Get-CsCertificate 執行之程序的詳細資訊。此參數值應該是將產生之 HTML 檔案的完整路徑；例如：-Report C:\Logs\Certificates.html。如果指定的檔案已經存在，將會自動以新資訊覆寫該檔案。 |
輸入類型
無。Get-CsCertificate 不接受管線傳送的輸入。
傳回類型
Get-CsCertificate 會傳回 Microsoft.Rtc.Management.Deployment.CertificateReference 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsCertificate
範例 1 所示的命令會傳回關於目前指派給 Lync Server 元件之憑證的資訊。這可以透過呼叫沒有任何額外參數的 Get-CsCertificate 完成。
-------------------------- 範例 2 ------------------------
Get-CsCertificate -Type WebServicesInternal
範例 2 會擷取用於內部 Web 服務的所有 Lync Server 憑證。若要這樣做，Type 參數會與參數值 WebServicesInternal 一起加入。
-------------------------- 範例 3 ------------------------
Get-CsCertificate | Where-Object {$_.NotAfter -lt "9/1/2011"}
以上的命令會傳回在 2011 年 9 月 1 日之前到期的所有 Lync Server 憑證。若要執行此工作，此命令會先使用 Get-CsCertificate 傳回目前使用中之所有 Lync Server 憑證的集合。接著，此集合會傳送至 Where-Object 指令程式，此指令程式只會選取在 2011 年 9 月 1 日之前過期的憑證。此範例中指定的日期 (9/1/2011) 採用美國英文格式的日期時間值。應該採用與您的 [地區及語言選項] 相容的格式來指定日期。
-------------------------- 範例 4 ------------------------
Get-CsCertificate | Where-Object {$_.Issuer -eq "Cn=MyCa"}
範例 4 會傳回關於憑證授權單位 (CA) MyCa 發行之所有 Lync Server 憑證的資訊。若要這樣做，此命令會先呼叫沒有任何參數的 Get-CsCertificate，以傳回目前使用中之所有憑證的集合。接著，此集合會傳送到 Where-Object，只挑出其 Issuer 屬性等於 (-eq) "Cn=MyCa" 的所有憑證。
-------------------------- 範例 5 ------------------------
Get-CsCertificate | Where-Object {$_.Subject -eq "CN=atl-cs-001.litwareinc.com"}
範例 5 所示的命令會傳回 Subject 屬性已設為 CN=atl-cs-001.litwareinc.com 的所有 Lync Server 憑證。這可以透過使用 Get-CsCertificate 傳回所有 Lync Server 憑證的集合，然後將該集合傳送到 Where-Object 指令程式來完成。接著，Where-Object 只會選取 Subject 屬性等於 "CN=atl-cs-001.litwareinc.com" 的憑證。