Remove-SPCertificate

Modul:

sharepoint-server

Gilt für::

SharePoint Server Subscription Edition

Löscht ein Zertifikat und alle zugeordneten privaten Schlüssel.

Syntax

Remove-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Löscht ein Zertifikat und alle zugeordneten privaten Schlüssel.

Folgendes geschieht, wenn Sie ein Zertifikat aus SharePoint löschen:

Standardmäßig lässt SharePoint das Löschen eines Zertifikats nicht zu, wenn es derzeit einem SharePoint-Objekt zugewiesen ist. Sie müssen das Standardverhalten mit dem Force-Parameter überschreiben, wenn Sie das Löschen eines Zertifikats erzwingen möchten. Wenn Sie das Standardverhalten überschreiben, werden vorhandene Zuweisungen des Zertifikats gelöscht.

Das Zertifikat und alle diesem Zertifikat zugeordneten privaten Schlüssel werden aus dem Windows-Zertifikatspeicher auf jedem Server in der SharePoint-Farm gelöscht.

Das Zertifikat und alle damit verbundenen privaten Schlüssel werden aus der SharePoint-Konfigurationsdatenbank gelöscht.

Alle vorherigen Exporte des Zertifikats über die SharePoint-Verwaltungsschnittstelle werden nicht gelöscht. Diese exportierten Dateien sind weiterhin vorhanden.

Beispiele

------------BEISPIEL-----------

Remove-SPCertificate -Identity "Team Sites Certificate"

In diesem Beispiel werden das Zertifikat "Teamwebsite-Zertifikat" und alle privaten Schlüssel gelöscht, die diesem Zertifikat zugeordnet sind.

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

-Force

Gibt an, dass das Zertifikat aus SharePoint gelöscht werden soll, auch wenn das Zertifikat derzeit SharePoint-Objekten zugewiesen ist. Wenn dieser Parameter angegeben wird, werden alle vorhandenen Zuweisungen des Zertifikats ebenfalls gelöscht. Wenn dieser Parameter nicht angegeben ist und das Zertifikat einem SharePoint-Objekt zugewiesen ist, schlägt der Vorgang fehl.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Identity

Das zertifikat, das aus SharePoint gelöscht werden soll.

Type:	SPServerCertificatePipeBind
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
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