Get-SPCertificate

參考

模組:: sharepoint-server

適用於:: SharePoint Server Subscription Edition

傳回符合指定準則的所有憑證。

Syntax

Get-SPCertificate
   [-DisplayName <String>]
   [-Thumbprint <String>]
   [-SerialNumber <String>]
   [-Store <String>]
   [-InUse]
   [-DaysToExpiration <Int32>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-SPCertificate
   [-Identity] <SPServerCertificatePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Get-SPCertificate Cmdlet 會傳回符合 Identity 參數的單一憑證，或是符合選擇性參數篩選準則的所有憑證。如果未指定任何參數，則會傳回伺服器陣列中的所有憑證。

範例

------------EXAMPLE 1-----------

Get-SPCertificate -DisplayName "Team Sites Certificate"

此範例會取得伺服器陣列中顯示名稱為「小組網站憑證」的所有憑證。

------------EXAMPLE 2-----------

Get-SPCertificate -InUse -DaysToExpiration 30

此範例會取得所有使用中且將在未來 30 天內到期的憑證。

參數

-AssignmentCollection

管理物件以適當處置它們。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。

使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysToExpiration

如果是正數，則只會傳回憑證，該憑證將在此參數現在指定的天數內過期。指定「-1」只傳回已過期的憑證。指定「0」將不會根據到期日進行篩選。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

要尋找之憑證的顯示名稱。如果多個憑證可能符合此準則，請使用此參數，而不是 Identity 參數。 Identity 參數只能傳回單一憑證。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

指定要尋找之憑證的顯示名稱、指紋、序號或 GUID。如果多個憑證符合指定的身分識別，則不會傳回任何憑證。當多個憑證相符時，請使用選擇性參數的篩選準則。

此類型必須是有效的顯示名稱，格式為「憑證顯示名稱」，這是有效的指紋，格式為「1234567890ABCDEF1234567890ABCDEF12345678」，格式為「1234567890ABCDEF1234567890ABCDEF」的有效序號或有效的 GUID，格式為「12345678-90ab-cdef-1234-567890abcdef」。

Type:	SPServerCertificatePipeBind
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InUse

指定只傳回直接指派給 SharePoint 物件的憑證 (也就是目前正在使用) 。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SerialNumber

要尋找之憑證的序號，格式為「1234567890ABCDEF1234567890ABCDEF」。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Store

指定要搜尋的憑證存放區。如果未指定此參數，則會搜尋所有憑證存放區。

Type:	String
Accepted values:	EndEntity, Intermediate, Pending, Root
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Thumbprint

要尋找之憑證的指紋，格式為「1234567890ABCDEF1234567890ABCDEF12345678」。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。未執行 Cmdlet。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False