共用方式為


Get-SPCertificate

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

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