Switch-SPCertificate

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

Sostituisce le assegnazioni di certificati esistenti con un nuovo certificato.

Sintassi

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

Descrizione

È possibile sostituire tutto l'utilizzo di un certificato all'interno di SharePoint con un certificato diverso. Ad esempio, se un certificato esistente si sta avvicinando alla scadenza ed è stato importato un nuovo certificato per sostituirlo. Usare il cmdlet Switch-SPCertificate per sostituire le assegnazioni di un certificato con un certificato diverso. Tutto l'utilizzo del certificato all'interno di SharePoint verrà quindi sostituito con il certificato diverso.

Esempio

------------ESEMPIO-----------

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

Questo esempio sostituisce le assegnazioni del certificato "Team Sites Certificate (2020)" con il certificato "Team Sites Certificate (2021)".

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-Identity

Certificato di cui si desidera sostituire le assegnazioni.

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

-NewCertificate

Certificato che deve sostituire tutte le assegnazioni del certificato specificate dal parametro Identity.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Share via