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 |