Import-SPCertificate

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

Importa i certificati nella farm di SharePoint.

Sintassi

Import-SPCertificate
      [-Path] <String>
      [-Password <SecureString>]
      [-Store <String>]
      [-Exportable]
      [-Replace]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Importa i certificati dal file specificato nella farm di SharePoint.

SharePoint supporta certificati RSA e ECC (Elliptic Curve Cryptography). È possibile importare certificati da file PFX (PKCS #12), file P7B (PKCS #7) e file CER. Solo i file PFX conterrà chiavi private per i certificati, necessarie per l'assegnazione di un certificato server a un sito Web IIS. Tuttavia, l'intera catena di certificati, dal certificato dell'entità finale (foglia) al certificato radice, deve essere importata in SharePoint per consentire il corretto funzionamento delle connessioni SSL.

I certificati vengono distribuiti automaticamente nell'archivio certificati di Windows in ogni server della farm di SharePoint quando vengono importati in SharePoint. I certificati vengono distribuiti automaticamente anche ai nuovi server nella farm di SharePoint quando tali server vengono aggiunti alla farm.

La disconnessione di un server da una farm di SharePoint non rimuoverà automaticamente i certificati gestiti da SharePoint dall'archivio certificati Windows del server. La disinstallazione di SharePoint da un server non rimuoverà automaticamente i certificati gestiti da SharePoint dall'archivio certificati Windows di tale server.

Esempio

------------EXAMPLE 1-----------

$password = ConvertTo-SecureString -AsPlainText -Force 
 
Import-SPCertificate -Path "\\server\fileshare\certificates.pfx" -Password $password -Exportable

In questo esempio vengono importati i certificati e le eventuali chiavi private associate dal file \\server\fileshare\certificates.pfx nella farm di SharePoint. Consente inoltre l'esportazione di chiavi private importate durante questa operazione da SharePoint in futuro.

------------EXAMPLE 2-----------

Import-SPCertificate -Path D:\test.cer

In questo esempio viene importato un certificato dal file D:\test.cer nella farm di SharePoint.

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

-Exportable

Specifica se le chiavi private dei certificati importati in SharePoint possono essere esportate. Se questo parametro non viene specificato, le chiavi private dei certificati distribuiti nell'archivio certificati di Windows in ogni server della farm di SharePoint non saranno esportabili e SharePoint non consentirà di esportare le chiavi private dall'interfaccia di amministrazione di SharePoint.

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

-Password

Password se il file del certificato è protetto da una password (per i file PFX).

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

-Path

Percorso del file PFX, P7B o CER contenente i certificati.

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

-Replace

Specifica che se i certificati importati rinnovano i certificati esistenti, le assegnazioni dei certificati esistenti devono essere immediatamente sostituite con i certificati importati.

Se i certificati importati non rinnovano i certificati esistenti, non verranno apportate modifiche all'assegnazione dei certificati.

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

-Store

Archivio certificati in cui devono essere importati i certificati. A meno che non sia necessario eseguire l'override del rilevamento automatico dei certificati di SharePoint, è consigliabile omettere questo parametro in modo che SharePoint selezioni automaticamente l'archivio certificati appropriato per ogni certificato.

Type:	String
Accepted values:	EndEntity, Intermediate, Pending, Root
Position:	Named
Default value:	None
Required:	False
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