Import-SPCertificate
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 -ExportableIn 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.cerIn 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 |