New-ExchangeCertificate

Le commutateur BinaryEncoded spécifie s’il faut encoder la nouvelle demande de certificat à l’aide de Distinguished Encoding Rules (DER). Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’utilisez pas ce commutateur, la requête est encodée en Base64.

Ce commutateur est disponible uniquement lorsque vous utilisez le commutateur GenerateRequest.

Pour les demandes codées en Base64, vous envoyez le contenu du fichier à l’autorité de certification. Pour les demandes encodées par DER, vous envoyez le fichier de certificat lui-même.

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 DomainName spécifie un ou plusieurs noms de noms de domaine complets ou de serveurs pour le champ Autre nom de l’objet (également appelé nom de remplacement de l’objet ou champ SAN) de la demande de certificat ou du certificat auto-signé.

Si la valeur dans le champ Objet du certificat ne correspond pas au nom du serveur de destination ou au nom de domaine complet, le demandeur recherche une correspondance dans le champ Autre nom de l’objet.

En règle générale, les valeurs incluent des noms de serveur (par exemple, Mailbox01) et des noms de domaine complets (par exemple, mail.contoso.com). Vous pouvez spécifier plusieurs valeurs séparées par des virgules. Les valeurs peuvent contenir les caractères a à z, 0 à 9 et le trait d’union (-). La longueur du nom de domaine ne peut pas dépasser 255 caractères.

La valeur par défaut inclut le nom et le nom de domaine complet du serveur Exchange lorsque les deux conditions suivantes sont remplies :

• Vous n’utilisez pas ce paramètre.
• Vous n’utilisez aucun de ces paramètres : IncludeAcceptedDomains, IncludeAutoDiscover, IncludeServerFQDN ou IncludeServerNetBIOSName.

Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Par défaut, lorsque vous créez un certificat auto-signé activé pour SMTP (aucun paramètre Services ou le paramètre Services contient la valeur SMTP), vous êtes invité à remplacer le certificat SMTP par défaut existant par le nouveau que vous créez. Si vous utilisez le commutateur Forcer, le nouveau certificat SMTP remplace automatiquement le certificat SMTP existant sans demander.

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

La valeur par défaut est Microsoft Exchange. La valeur de nom convivial est un texte descriptif et n’affecte pas la fonctionnalité du certificat.

Le commutateur GenerateRequest spécifie que vous créez une demande de certificat pour une autorité de certification. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

L’utilisation de ce commutateur et l’exportation de la sortie vers un fichier génèrent une demande de certificat PKCS #10 que vous envoyez à l’autorité de certification. La façon dont vous envoyez les informations dépend de l’autorité de certification, mais en règle générale, pour les demandes encodées en Base64, vous collez le contenu dans un message électronique ou dans le formulaire de demande sur le site web de l’autorité de certification.

Après avoir installé le certificat à partir de l’autorité de certification à l’aide de l’applet de commande Import-ExchangeCertificate, vous utilisez l’applet de commande Enable-ExchangeCertficate pour activer le certificat pour les services Exchange.

Si vous n’utilisez pas ce commutateur, la commande crée un certificat auto-signé sur le serveur Exchange.

Le commutateur IncludeAcceptedDomains spécifie que tous les domaines acceptés dans l’organisation Exchange sont inclus dans le champ Autre nom de l’objet de la demande de certificat ou du certificat auto-signé. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Lorsque vous utilisez ce commutateur :

• Si vous avez déjà inclus un domaine accepté dans le paramètre DomainName, la valeur n’est pas dupliquée dans le champ Autre nom de l’objet.
• Pour les nouveaux certificats auto-signés, si vous n’utilisez pas le paramètre Services, le certificat est affecté uniquement à SMTP.

Le commutateur IncludeAutoDiscover spécifie s’il faut ajouter une autre valeur de nom de l’objet avec le préfixe découverte automatique pour chaque domaine accepté dans l’organisation Exchange. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Par exemple, si l’organisation a les domaines acceptés woodgrovebank.com et woodgrovebank.co.uk, l’utilisation de ce commutateur entraîne l’ajout des valeurs suivantes dans le champ Autre nom de l’objet :

• autodiscover.woodgrovebank.com
• autodiscover.woodgrovebank.co.uk

Lorsque vous utilisez ce commutateur :

• Si vous avez déjà inclus la valeur autodiscover.<AcceptedDomain> dans le paramètre DomainName, la valeur n’est pas dupliquée dans le champ Autre nom de l’objet.
• Pour les nouveaux certificats auto-signés, si vous n’utilisez pas le paramètre Services, le certificat est affecté uniquement à SMTP.

Le commutateur IncludeServerFQDN spécifie que le nom de domaine complet du serveur Exchange est inclus dans le champ Autre nom de l’objet de la nouvelle demande de certificat ou certificat auto-signé. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Lorsque vous utilisez ce commutateur et que vous avez déjà inclus le nom de domaine complet du serveur dans le paramètre DomainName, la valeur n’est pas dupliquée dans le champ Autre nom de l’objet.

Le commutateur IncludeServerNetBIOSName spécifie que le nom NetBIOS du serveur Exchange est inclus dans le champ Autre nom de l’objet de la nouvelle demande de certificat ou du certificat auto-signé. Vous n’avez pas besoin de spécifier une valeur avec ce commutateur

Lorsque vous utilisez ce commutateur et que vous avez déjà inclus le nom NetBIOS du serveur dans le paramètre DomainName, la valeur n’est pas dupliquée dans le champ Autre nom de l’objet.

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

Le paramètre KeySize spécifie la taille (en bits) de la clé publique RSA associée à la nouvelle demande de certificat ou au certificat auto-signé. Les valeurs valides sont les suivantes :

• 1024
• 2048 (il s’agit de la valeur par défaut)
• 4096

Le paramètre PrivateKeyExportable spécifie si le certificat a une clé privée exportable et contrôle si vous pouvez exporter le certificat à partir du serveur (et importer le certificat sur d’autres serveurs). Les valeurs valides sont les suivantes :

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

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 exporter la demande de certificat vers un fichier sans utiliser le paramètre RequestFile, consultez Les exemples 4 et 5 (nouveau) ou les exemples 7 et 8 (renouvellement).

Ce paramètre est disponible uniquement dans Exchange 2013.

Le paramètre RequestFile spécifie le nom et le chemin d’accès du fichier de demande de certificat. Le fichier contient les mêmes informations que celles affichées à l’écran lorsque vous générez une demande de certificat codé en Base64 (vous n’utilisez pas le commutateur BinaryEncoded).

Vous pouvez utiliser un chemin d’accès local si le certificat ou la demande de certificat se trouve sur le serveur Exchange où vous exécutez la commande. Sinon, utilisez un chemin UNC (\\Server\Share). Si la valeur contient des espaces, placez-la entre guillemets (").

Vous pouvez utiliser ce paramètre uniquement lorsque vous utilisez le commutateur GenerateRequest.

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 paramètre Services spécifie les services Exchange pour ant le nouveau certificat auto-signé. Les valeurs valides sont les suivantes :

• Aucun : vous pouvez activer le certificat pour les services Exchange ultérieurement à l’aide de l’applet de commande Enable-ExchangeCertificate.
• Fédération
• Services Internet (IIS)
• IMAP : n’activez pas de certificat générique pour le service IMAP4. Utilisez plutôt l’applet de commande Set-ImapSettings pour configurer le nom de domaine complet que les clients utilisent pour se connecter au service IMAP4.
• POP : n’activez pas de certificat générique pour le service POP3. À la place, utilisez la cmdlet Set-PopSettings pour configurer le nom de domaine complet que les clients utilisent pour se connecter au service POP3.
• SMTP : lorsque vous activez un certificat pour SMTP, vous êtes invité à remplacer le certificat auto-signé Exchange par défaut utilisé pour chiffrer le trafic SMTP entre exchange interne. Si vous souhaitez remplacer le certificat par défaut sans l’invite de confirmation, utilisez le commutateur Forcer.
• Messagerie unifiée : cette valeur nécessite que le paramètre UMStartupMode sur l’applet de commande Set-UMService soit défini sur TLS ou Double. Si le paramètre UMStartupMode est défini sur la valeur par défaut de TCP, vous ne pouvez pas activer le certificat pour le service de messagerie unifiée.
• UMCallRouter : cette valeur nécessite que le paramètre UMStartupMode sur l’applet de commande Set-UMCallRouterService soit défini sur TLS ou Double. Si le paramètre UMStartupMode est défini sur la valeur par défaut TCP, vous ne pouvez pas activer le certificat pour le service routeur d’appel de messagerie unifiée.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules. Les valeurs par défaut sont IMAP, POP et SMTP.

Vous ne pouvez pas utiliser ce paramètre avec le commutateur GenerateRequest.

Une fois que vous avez activé un certificat pour un service, vous ne pouvez pas supprimer le service du certificat.

Le paramètre SubjectKeyIdentifier spécifie l’identificateur de clé d’objet unique pour un nouveau certificat auto-signé. Par exemple, exécutez la commande : $ski = [System.Guid]::NewGuid(). ToString(« N »), et utilisez la valeur $ski pour ce paramètre.

Le paramètre SubjectName spécifie le champ Subject de la demande de certificat ou du certificat auto-signé.

Chaque certificat nécessite une valeur pour le champ Objet, et une seule valeur est autorisée. Le demandeur tente de faire correspondre le nom ou le nom de domaine complet du serveur de destination avec la valeur de nom commun (CN) de l’objet.

Ce paramètre utilise la syntaxe : [C=CountryOrRegion,S=StateOrProvince,L=LocalityOrCity,O=Organization,OU=Department],CN=HostNameOrFQDN. Bien que la seule valeur requise soit CN=HostNameOrFQDN, vous devez toujours inclure pour les C=CountryOrRegion demandes de certificat, mais d’autres valeurs peuvent également être requises par l’autorité de certification.

Par exemple, si vous souhaitez que l’objet du certificat soit mail.contoso.com dans le États-Unis, vous pouvez utiliser l’une des valeurs suivantes :

• C=US,S=WA,L=Redmond,O=Contoso,OU=IT,CN=mail.contoso.com
• C=US,O=Contoso,CN=mail.contoso.com
• C=US,CN=mail.contoso.com

Si vous n’utilisez pas ce paramètre, la valeur par défaut est le nom du serveur Exchange sur lequel vous exécutez la commande (par exemple, CN=Mailbox01).

Pour un certificat SAN (Subject Alternative Name), vous devez choisir l’une des valeurs du paramètre DomainName à utiliser dans la valeur SubjectName. En fait, la valeur CN que vous spécifiez pour SubjectName est automatiquement incluse dans les valeurs DomainName.

Pour un certificat générique, utilisez une valeur SubjectName qui contient le caractère générique (*). Par exemple, C=US,CN=*.contoso.com.

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.