Switch-SPCertificate

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

Ersetzt vorhandene Zertifikatzuweisungen durch ein neues Zertifikat.

Syntax

Switch-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      [-NewCertificate] <SPServerCertificatePipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Möglicherweise möchten Sie die gesamte Verwendung eines Zertifikats in SharePoint durch ein anderes Zertifikat ersetzen. Wenn sich beispielsweise ein vorhandenes Zertifikat dem Ablauf nähert und Sie ein neues Zertifikat importiert haben, um es zu ersetzen. Verwenden Sie das Cmdlet Switch-SPCertificate, um die Zuweisungen eines Zertifikats durch ein anderes Zertifikat zu ersetzen. Die gesamte Verwendung dieses Zertifikats in SharePoint wird dann durch das andere Zertifikat ersetzt.

Beispiele

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

Switch-SPCertificate -Identity "Team Sites Certificate (2020)" -NewCertificate "Team Sites Certificate (2021)"

In diesem Beispiel werden die Zuweisungen des Zertifikats "Teamwebsite-Zertifikat (2020)" durch das Zertifikat "Teamwebsite-Zertifikat (2021)" ersetzt.

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

-Identity

Das Zertifikat, dessen Zuweisungen Sie ersetzen möchten.

Type:	SPServerCertificatePipeBind
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NewCertificate

Das Zertifikat, das alle Zuweisungen des durch den Identity-Parameter angegebenen Zertifikats ersetzen soll.

Type:	SPServerCertificatePipeBind
Position:	1
Default value:	None
Required:	True
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

Freigeben über