Set-ActiveSyncVirtualDirectory (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-11
La cmdlet Set-ActiveSyncVirtualDirectory permet de configurer les paramètres Microsoft 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>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>]
Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>]
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 le 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 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 |
BasicAuthEnabled |
Facultatif |
System.Boolean |
Ce paramètre active ou désactive l’authentification de base. Le paramètre par défaut est |
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 |
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 |
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. |
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 Windows SharePoint Services ou de partage de fichiers 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. |
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