Remove-SPCertificate
Elimina un certificato e qualsiasi chiave privata associata.
Sintassi
Remove-SPCertificate
[-Identity] <SPServerCertificatePipeBind>
[-Force]
[-AssignmentCollection <SPAssignmentCollection>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Elimina un certificato e qualsiasi chiave privata associata.
Quando si elimina un certificato da SharePoint, si verifica quanto segue:
Per impostazione predefinita, SharePoint non consente di eliminare un certificato se è attualmente assegnato a un oggetto SharePoint. È necessario eseguire l'override del comportamento predefinito con il parametro Force se si vuole forzare l'eliminazione di un certificato. Se si esegue l'override del comportamento predefinito, le assegnazioni esistenti del certificato vengono cancellate.
Il certificato e qualsiasi chiave privata associata a tale certificato vengono eliminati dall'archivio certificati di Windows in ogni server della farm di SharePoint.
Il certificato e qualsiasi chiave privata associata vengono eliminati dal database di configurazione di SharePoint.
Le esportazioni precedenti del certificato tramite l'interfaccia di amministrazione di SharePoint non verranno eliminate. Tali file esportati continueranno a esistere.
Esempio
------------ESEMPIO-----------
Remove-SPCertificate -Identity "Team Sites Certificate"
In questo esempio vengono eliminati il certificato "Certificato siti del team" e qualsiasi chiave privata associata a tale certificato.
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 |
-Force
Specifica che il certificato deve essere eliminato da SharePoint, anche se il certificato è attualmente assegnato agli oggetti di SharePoint. Se questo parametro viene specificato, vengono cancellate anche le assegnazioni esistenti del certificato. Se questo parametro non viene specificato e il certificato viene assegnato a un oggetto SharePoint, l'operazione avrà esito negativo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Identity
Certificato da eliminare da SharePoint.
Type: | SPServerCertificatePipeBind |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |