Export-SPCertificate

Référence

Module:: sharepoint-server

Exporte des certificats à partir de la batterie de serveurs SharePoint.

Syntax

Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Password <SecureString>
      [-EncryptionType <String>]
      [-IncludeAllCertificatesInCertificationPath]
      [-NoExtendedProperties]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Export-SPCertificate
      [-Identity] <SPServerCertificatePipeBind>
      -Type <String>
      [-IncludeAllCertificatesInCertificationPath]
      [-Path <String>]
      [-Force]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Exporte les certificats de la batterie de serveurs SharePoint dans un fichier de certificat. Ce fichier de certificat exporté est stocké dans le site Administration centrale par défaut, mais peut également être stocké dans un chemin d’accès spécifié par le paramètre Path.

SharePoint prend en charge l’exportation de certificats vers des fichiers PFX (PKCS #12), des fichiers P7B (PKCS #7) et des fichiers CER. Les fichiers PFX et P7B peuvent contenir plusieurs certificats, ce qui est utile pour exporter une chaîne de certificats du certificat d’entité finale (feuille) vers le certificat racine. Toutefois, seuls les fichiers PFX peuvent contenir des clés privées pour les certificats, qui sont nécessaires pour qu’un certificat de serveur soit affecté à un site web IIS. Les fichiers CER ne contiennent qu’un seul certificat.

Exemples

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

$password = ConvertTo-SecureString -AsPlainText -Force 
 
Export-SPCertificate -Identity "Team Sites Certificate" -Password $password -IncludeAllCertificatesInCertificationPath -Path "\\server\fileshare\certificates.pfx"

Cet exemple exporte le certificat « Team Sites Certificate » et sa clé privée, ainsi que d’autres certificats de sa chaîne de certificats, dans le fichier \\server\fileshare\certificates.pfx.

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

Export-SPCertificate -Identity "Team Sites Certificate" -Type Cert

Cet exemple exporte le certificat « Certificat de sites d’équipe » dans un fichier de certificat stocké dans l’Administration centrale.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-EncryptionType

Spécifie l’algorithme de chiffrement à utiliser pour protéger le fichier PFX exporté. AES256 spécifie que le chiffrement AES-256 avec hachage SHA256 sera utilisé. TripleDes spécifie que le chiffrement 3DES avec hachage SHA1 sera utilisé. Le chiffrement AES-256 est plus fort que le chiffrement 3DES, mais n’est pris en charge qu’avec les fichiers PFX sur Windows Server 2019 et les systèmes d’exploitation plus récents. Utilisez le chiffrement 3DES si le fichier PFX doit être compatible avec des systèmes d’exploitation plus anciens. Si ce paramètre n’est pas spécifié, le chiffrement AES-256 est utilisé par défaut. Ce paramètre est uniquement compatible avec les fichiers PFX.

Type:	String
Accepted values:	AES256, TripleDes
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Spécifie de remplacer un fichier s’il existe déjà au chemin d’accès spécifié.

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

-Identity

Certificat à exporter.

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

-IncludeAllCertificatesInCertificationPath

Spécifie s’il faut exporter des certificats supplémentaires qui font partie de la chaîne de certificats du certificat spécifié. Cela ajoute uniquement les certificats parents du certificat spécifié, et non les certificats enfants émis par le certificat spécifié. Ce paramètre est uniquement compatible avec les fichiers PFX et P7B.

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

-NoExtendedProperties

Spécifie si les propriétés étendues du certificat ne doivent pas être exportées, telles que le nom convivial du certificat. Ce paramètre est uniquement compatible avec les fichiers PFX.

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

-Password

Mot de passe à utiliser pour protéger le fichier PFX exporté. Ce paramètre est uniquement compatible avec les fichiers PFX.

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

-Path

Chemin d’accès au fichier PFX, P7B ou CER vers lequel les certificats doivent être exportés.

Les certificats seront également exportés vers un fichier de certificat stocké dans l’Administration centrale, que ce paramètre soit spécifié ou non.

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

-Type

Spécifie le type de fichier à générer. Le certificat génère un fichier CER contenant un seul certificat codé en DER. Pkcs7 génère un fichier P7B (PKCS #7) contenant un ou plusieurs certificats. Ce paramètre est uniquement compatible avec les fichiers CER et P7B.

Type:	String
Accepted values:	Cert, Pkcs7
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. Le cmdlet n’est pas exécutée.

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

Partager via