Import-ExchangeCertificate

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

• Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
• La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Les serveurs de transport Edge ne prennent pas en charge le paramètre DomainController. Un serveur de transport Edge utilise l’instance locale des services AD LDS (Active Directory Lightweight Directory Services) pour lire et écrire des données.

Le paramètre FileData spécifie le contenu du fichier de certificat que vous souhaitez importer.

Une valeur valide pour ce paramètre vous oblige à lire le fichier dans un objet codé en octets à l’aide de la syntaxe suivante : ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Vous pouvez utiliser cette commande comme valeur de paramètre, ou vous pouvez écrire la sortie dans une variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) et utiliser la variable comme valeur de paramètre ($data).

Vous pouvez utiliser un chemin d’accès local si le fichier de certificat se trouve sur le serveur Exchange sur lequel vous exécutez la commande, et s’il s’agit du même serveur que celui où vous souhaitez installer le certificat. Sinon, utilisez un chemin UNC (\\Server\Share).

Lorsque vous utilisez ce paramètre pour importer des fichiers de certificat texte PKCS #7, ces fichiers contiennent : -----BEGIN CERTIFICATE----- et -----END CERTIFICATE----- ou -----BEGIN PKCS7----- et -----END PKCS7----- et ont des extensions de nom de fichier .p7b ou .p7c.

Si la valeur contient des espaces, placez-la entre guillemets (").

Remarque : Ce paramètre a été supprimé d’Exchange 2016 et Exchange 2019 par la Mises à jour cumulative H1 2022, car il accepte les valeurs de chemin UNC. Pour importer un fichier de certificat sans utiliser le paramètre FileName, utilisez le paramètre FileData.

Ce paramètre est disponible uniquement dans Exchange 2013.

Le paramètre FileName spécifie le fichier de certificat que vous souhaitez importer. En règle générale, vous utilisez ce paramètre pour les fichiers de certificat binaires PKCS #12 dont les extensions de nom de fichier sont .cer, .crt, .der, .p12, ou .pfx. Ce type de fichier de certificat binaire est protégé par un mot de passe lorsque le fichier contient la clé privée ou la chaîne d’approbation.

Vous pouvez utiliser un chemin d’accès local si le fichier de certificat se trouve sur le serveur Exchange sur lequel vous exécutez la commande, et s’il s’agit du même serveur que celui où vous souhaitez installer le certificat. Sinon, utilisez un chemin UNC (\\Server\Share).

Si la valeur contient des espaces, placez-la entre guillemets (").

Le paramètre FriendlyName spécifie un nom convivial pour le certificat. La valeur doit compter moins de 64 caractères.

La valeur de nom convivial est un texte descriptif et n’affecte pas les fonctionnalités du certificat.

Ce paramètre est obsolète et inutilisé.

Le paramètre Password spécifie le mot de passe requis pour importer le certificat.

Vous pouvez utiliser les méthodes suivantes comme valeur pour ce paramètre :

• (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).
• Avant d’exécuter cette commande, stockez le mot de passe en tant que variable (par exemple, $password = Read-Host "Enter password" -AsSecureString), puis utilisez la variable ($password) pour la valeur.
• (Get-Credential).password pour être invité à entrer le mot de passe en toute sécurité lorsque vous exécutez cette commande.

Le paramètre PrivateKeyExportable spécifie si le certificat dispose d’une clé privée exportable et contrôle si vous pouvez exporter le certificat à partir de ce serveur. Les valeurs valides sont les suivantes :

• $true : la clé privée étant exportable, vous pouvez exporter le certificat à partir de ce serveur.
• $false : la clé privée n’est pas exportable. Vous ne pouvez donc pas exporter le certificat à partir de ce serveur. Il s’agit de la valeur par défaut.

Le paramètre Server définit le serveur Exchange sur lequel vous souhaitez exécuter cette commande. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

• Nom
• FQDN
• Nom unique
• DN Exchange hérité

DN Exchange hérité

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.