Get-SPCertificate

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

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 30

In 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