Set-AuthConfig

Référence

Module:: ExchangePowerShell

S’applique à:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

La cmdlet est disponible uniquement dans Exchange en local.

Utilisez l’applet de commande Set-AuthConfig pour modifier la configuration d’autorisation de votre organisation Exchange.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Set-AuthConfig
   -CertificateThumbprint <String>
   [-SkipImmediateCertificateDeployment]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Set-AuthConfig
   [-ClearPreviousCertificate]
   [-PublishCertificate]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Set-AuthConfig
   [-NewCertificateEffectiveDate <DateTime>]
   [-NewCertificateThumbprint <String>]
   [-SkipImmediateCertificateDeployment]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-Server <ServerIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Set-AuthConfig
   [-Realm <String>]
   [-ServiceName <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

Description

Le paramètre Set-AuthConfig définit Microsoft Exchange en tant qu’application partenaire pour l’authentification de serveur à serveur avec d’autres applications partenaires telles que Microsoft SharePoint 2013 et Microsoft Lync 2013 ou Skype Entreprise Server 2015, y compris le certificat utilisé pour la signature des jetons. Il n’est généralement pas nécessaire que cette configuration soit modifiée, sauf dans certains cas où vous devez utiliser un certificat différent au lieu du certificat auto-signé créé par le programme d’installation d’Exchange ou pour utiliser un nouveau certificat après l’expiration de l’ancien certificat.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Set-AuthConfig -NewCertificateThumbprint DB821B4FCA2A5DA9593B9DE00C86BC5EA35D0FC0 -NewCertificateEffectiveDate 4/17/2014

Cet exemple spécifie un nouveau certificat et une date d’entrée en vigueur du certificat.

Exemple 2

Set-AuthConfig -PublishCertificate

Cet exemple remplace immédiatement le certificat configuré en tant que certificat suivant et en fait le certificat actuel. Vous devez avoir installé un certificat marqué comme certificat suivant.

Paramètres

-CertificateThumbprint

Le paramètre CertificateThumbprint spécifie l’empreinte numérique du certificat à utiliser par Exchange pour l’authentification de serveur à serveur.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ClearPreviousCertificate

Le commutateur ClearPreviousCertificate efface le certificat qui a été enregistré comme certificat précédent dans la configuration d’autorisation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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 ».

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Force

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.

Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-NewCertificateEffectiveDate

Le paramètre NewCertificateEffectiveDate spécifie une date à laquelle le certificat configuré comme certificat suivant doit être utilisé.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-NewCertificateThumbprint

Le paramètre NewCertificateThumbprint spécifie l’empreinte numérique du nouveau certificat à utiliser comme certificat suivant dans la configuration d’autorisation.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-PublishCertificate

Le commutateur PublishCertificate remplace immédiatement le certificat spécifié en tant que certificat actuel. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le certificat est immédiatement déployé sur tous les serveurs d’accès au client.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Realm

Le paramètre Realm spécifie un domaine de sécurité pour les applications partenaires. Si un service ou un utilisateur présente un jeton à partir d’un domaine qui n’est pas un domaine accepté dans l’organisation Exchange, le jeton doit contenir le domaine spécifié pour accéder aux ressources.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Le paramètre Server n’est pas disponible dans cette version.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ServiceName

Le paramètre ServiceName identifie Microsoft Exchange à d’autres applications partenaires telles que SharePoint 2013.

Le programme d’installation d’Exchange configure le paramètre ServiceName avec une valeur constante spécifique. Vous ne devez pas modifier ce paramètre. La modification du paramètre ServiceName peut entraîner le non-fonctionnement de l’authentification de serveur à serveur auprès des applications partenaires.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SkipImmediateCertificateDeployment

Le commutateur SkipImmediateCertificateDeployment spécifie que le certificat ne doit pas être utilisé immédiatement. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

L’utilisation de ce commutateur n’est pas recommandée dans un environnement de production.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.