Get-SPCertificate
指定した条件に一致するすべての証明書を返します。
構文
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>]説明
Get-SPCertificate コマンドレットは、Identity パラメーターに一致する 1 つの証明書、または省略可能なパラメーターのフィルター条件に一致するすべての証明書を返します。 パラメーターが指定されていない場合は、ファーム内のすべての証明書が返されます。
例
------------EXAMPLE 1-----------
Get-SPCertificate -DisplayName "Team Sites Certificate"この例では、"Team Sites Certificate" という表示名を持つファーム内のすべての証明書を取得します。
------------EXAMPLE 2-----------
Get-SPCertificate -InUse -DaysToExpiration 30この例では、使用中のすべての証明書を取得し、今後 30 日以内に有効期限が切れます。
パラメーター
-AssignmentCollection
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 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 パラメーターは、1 つの証明書のみを返すことができます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Identity
検索する証明書の表示名、拇印、シリアル番号、または GUID を指定します。 複数の証明書が指定した ID と一致する場合、証明書は返されません。 複数の証明書が一致する場合は、省略可能なパラメーターのフィルター条件を使用します。
型は、"証明書の表示名" という形式の有効な表示名である必要があります。有効な拇印は"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
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |