Set-ActiveSyncVirtualDirectory

Article
09/30/2014

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2012-03-26

La cmdlet Set-ActiveSyncVirtualDirectory permet de configurer les paramètres Microsoft Exchange ActiveSync pour un répertoire virtuel spécifié.

Syntaxe

Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Description détaillée

La cmdlet Set-ActiveSyncVirtualDirectory permet de configurer une série de paramètres pour un répertoire virtuel utilisé pour Exchange ActiveSync.

Pour exécuter la cmdlet Set-ActiveSyncVirtualDirectory, vous devez utiliser un compte auquel ont été délégués le rôle Administrateur de serveur Exchange et l'appartenance au groupe Administrateurs local pour le serveur cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre	Obligatoire	Type	Description
Identity	Obligatoire	Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter	Ce paramètre identifie de façon univoque le répertoire virtuel Exchange ActiveSync à configurer. La valeur doit être website\microsoft-server-activesync.
ActiveSyncServer	Facultatif	System.String	Ce paramètre spécifie l'adresse URL du serveur d'accès au client. Cette valeur se présente dans le format suivant : https://servername/Microsoft-Server-ActiveSync.
BadItemReportingEnabled	Facultatif	System.Boolean	Ce paramètre spécifie si les éléments ne pouvant pas être synchronisés doivent être signalés à l’utilisateur. Si le paramètre est défini sur `$true`, l’utilisateur reçoit une notification lorsqu’un élément ne peut pas être synchronisé avec le périphérique mobile.
BasicAuthEnabled	Facultatif	System.Boolean	Ce paramètre active ou désactive l’authentification de base. Le paramètre par défaut est `$true`.
ClientCertAuth	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes	Ce paramètre spécifie l’état de l’authentification de certificats clients. L’authentification de certificats clients est désactivée par défaut. La valeur par défaut de ce paramètre est `$null`.
CompressionEnabled	Facultatif	System.Boolean	Ce paramètre est un nombre entier identifiant la compression appliquée au répertoire virtuel Exchange ActiveSync spécifié. Le paramètre par défaut est `$true`.
Confirm	Facultatif	System.Management.Automation.SwitchParameter	Ce paramètre suspend le traitement par la commande et vous demande de confirmer les actions que la commande va effectuer avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.
DomainController	Facultatif	Microsoft.Exchange.Data.Fqdn	Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController dans la commande.
ExternalAuthenticationMethods	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre spécifie les méthodes d'authentification prises en charge par le serveur contenant le répertoire virtuel quand un accès est demandé depuis l'extérieur du pare-feu du réseau. Si ce paramètre n'est pas défini, toutes les méthodes d'authentification peuvent être utilisées.
ExternalUrl	Facultatif	System.Uri	Ce paramètre spécifie l'URL utilisée pour se connecter au répertoire virtuel depuis l'extérieur du pare-feu réseau.
InstallIsapiFilter	Facultatif	System.Boolean	Le paramètre InstallIsapiFilter spécifie si le filtre ISAPI (Internet Server API) est installé.
InstallProxySubDirectory	Facultatif	System.Boolean	Le paramètre InstallProxySubDirectory contrôle la création du sous-répertoire Exchange ActiveSync utilisé comme proxy entre Microsoft Exchange Server 2010 et Exchange Server 2007.
Instance	Facultatif	Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory	Le paramètre Instance permet de transmettre un objet à la commande à traiter. Il est principalement utilisé dans des scripts où un objet complet doit être transmis à la commande.
InternalAuthenticationMethods	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre spécifie les méthodes d'authentification prises en charge par le serveur contenant le répertoire virtuel quand un accès est demandé depuis l'intérieur du pare-feu du réseau. Si ce paramètre n'est pas défini, toutes les méthodes d'authentification peuvent être utilisées.
InternalUrl	Facultatif	System.Uri	Ce paramètre est utilisé pour la fonction proxy HTTP du serveur d’accès au client. Si ce paramètre est défini, le serveur d’accès au client qui reçoit les connexions clientes entrantes transmet par proxy les demandes à cette adresse URL. Il peut s’agir du de nom de domaine complet (FQDN) d’une URL Internet ou d’un nom d’hôte interne.
MobileClientCertificateAuthorityURL	Facultatif	System.String	Ce paramètre spécifie l’adresse URL de l’autorité de certification utilisée par le périphérique mobile.
MobileClientCertificateProvisioningEnabled	Facultatif	System.Boolean	Ce paramètre spécifie si le service de découverte automatique renvoie l’adresse URL du serveur des services de certificats dans le fichier XML.
MobileClientCertTemplateName	Facultatif	System.String	Ce paramètre spécifie le nom de modèle pour le certificat client.
Name	Facultatif	System.String	Ce paramètre spécifie le nom du répertoire virtuel Exchange ActiveSync.
RemoteDocumentsActionForUnknownServers	Facultatif	System.Nullable	Ce paramètre spécifie l'action effectuée lorsqu'une demande de partage de fichiers Windows SharePoint Services ou Windows est adressée via Exchange ActiveSync. Lorqu’une demande est adressée, Exchange ActiveSync recherche le nom d'hôte requis dans les listes vertes et les listes rouges. Si le nom d’hôte n’est trouvé dans aucune liste, l’action spécifiée dans ce paramètre (Bloquer ou Autoriser) est effectuée.
RemoteDocumentsAllowedServers	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre est une propriété à valeurs multiples qui répertorie les serveurs autorisés pour l’accès à des documents distants.
RemoteDocumentsBlockedServers	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre est une propriété à valeurs multiples qui répertorie les serveurs bloqués pour l’accès à des documents distants.
RemoteDocumentsInternalDomainSuffixList	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre est utilisé dans les organisations qui n’exécutent pas WINS dans leur réseau. Dans ces environnements, vous pouvez spécifier un ou plusieurs noms de domaine complet qui sont traités par Exchange ActiveSync comme internes lorsqu’une demande d’accès au fichier distant est reçue.
WhatIf	Facultatif	System.Management.Automation.SwitchParameter	Ce paramètre donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce à ce paramètre, vous pouvez afficher des changements potentiels sans devoir les appliquer. Vous n'avez pas besoin de spécifier une valeur avec ce paramètre.
WindowsAuthEnabled	Facultatif	System.Boolean	Ce paramètre spécifie si l'authentification intégrée Windows est activée sur le répertoire virtuel Exchange ActiveSync.

Types d'entrées

Types de retours

Erreurs

Erreur	Description

Exceptions

Exceptions	Description

Exemple

L'exemple de code suivant désactive l'authentification de base pour le répertoire virtuel Exchange ActiveSync par défaut sur le serveur nommé Contoso.

Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false