Get-SPCertificate
Gibt alle Zertifikate zurück, die den angegebenen Kriterien entsprechen.
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>]Beschreibung
Das Cmdlet Get-SPCertificate gibt entweder ein einzelnes Zertifikat zurück, das dem Identity-Parameter entspricht, oder alle Zertifikate, die den Filterkriterien der optionalen Parameter entsprechen. Wenn keine Parameter angegeben sind, werden alle Zertifikate in der Farm zurückgegeben.
Beispiele
------------BEISPIEL 1-----------
Get-SPCertificate -DisplayName "Team Sites Certificate"In diesem Beispiel werden alle Zertifikate in der Farm mit dem Anzeigenamen "Teamwebsitezertifikat" abgerufen.
------------BEISPIEL 2-----------
Get-SPCertificate -InUse -DaysToExpiration 30In diesem Beispiel werden alle Zertifikate abgerufen, die verwendet werden und innerhalb der nächsten 30 Tage ablaufen.
Parameter
-AssignmentCollection
Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.
Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysToExpiration
Bei einer positiven Zahl werden nur Zertifikate zurückgegeben, die in der von diesem Parameter angegebenen Anzahl von Tagen ablaufen. Geben Sie "-1" an, um nur zertifikate zurückzugeben, die bereits abgelaufen sind. Die Angabe von "0" führt dazu, dass keine Filterung basierend auf dem Ablaufdatum erfolgt.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Der Anzeigename des zu suchden Zertifikats. Verwenden Sie diesen Parameter anstelle des Parameters Identity, wenn mehrere Zertifikate diesem Kriterium entsprechen. Der Identity-Parameter kann nur ein einzelnes Zertifikat zurückgeben.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Identity
Gibt den Anzeigenamen, den Fingerabdruck, die Seriennummer oder die GUID des zu suchenden Zertifikats an. Wenn mehrere Zertifikate mit der angegebenen Identität übereinstimmen, werden keine Zertifikate zurückgegeben. Verwenden Sie die Filterkriterien der optionalen Parameter, wenn mehrere Zertifikate übereinstimmen würden.
Der Typ muss ein gültiger Anzeigename im Format "Zertifikatanzeigename", ein gültiger Fingerabdruck, im Format "1234567890ABCDEF1234567890ABCDEF12345678" sein. eine gültige Seriennummer im Format "1234567890ABCDEF1234567890ABCDEF" oder eine gültige GUID im Format "12345678-90ab-cdef-1234-567890abcdef".
| Type: | SPServerCertificatePipeBind |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InUse
Gibt an, dass nur Zertifikate zurückgegeben werden sollen, die SharePoint-Objekten direkt zugewiesen sind (d. h. derzeit verwendet).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SerialNumber
Die Seriennummer des zu suchden Zertifikats im Format "1234567890ABCDEF1234567890ABCDEF".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Store
Gibt den zu durchsuchenden Zertifikatspeicher an. Wenn dieser Parameter nicht angegeben ist, werden alle Zertifikatspeicher durchsucht.
| Type: | String |
| Accepted values: | EndEntity, Intermediate, Pending, Root |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Thumbprint
Der Fingerabdruck des zu suchenden Zertifikats im Format "1234567890ABCDEF1234567890ABCDEF12345678".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |