New-ActiveSyncVirtualDirectory
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2009-05-14
La commande New-ActiveSyncVirtualDirectory permet de créer des répertoires virtuels Microsoft Exchange ActiveSync sur vos sites Web spécifiés.
Syntaxe
New-ActiveSyncVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La commande New-ActiveSyncVirtualDirectory entraîne la création d'un répertoire virtuel Exchange ActiveSync sur le serveur spécifié dans le site Web spécifié. Le répertoire virtuel Exchange ActiveSync créé est nommé « Microsoft-ActiveSync-Server ». Il ne peut y avoir qu'un seul répertoire virtuel Exchange ActiveSync dans chaque site Web Exchange ActiveSync.
Pour exécuter la cmdlet New-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 |
|---|---|---|---|
ApplicationRoot |
Facultatif |
System.String |
Ce paramètre définit le chemin de métabase du répertoire virtuel. Par défaut, ce chemin est celui du site Web dans lequel le répertoire virtuel est créé. |
AppPoolId |
Facultatif |
System.String |
Ce paramètre définit le pool de programmes pouvant être utilisés avec le répertoire virtuel. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre Confirm suspend le traitement par la commande et demande à l'administrateur de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory. |
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. |
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. |
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 spécifie l'URL utilisée pour se connecter au répertoire virtuel depuis l'intérieur du pare-feu du réseau. |
Path |
Facultatif |
System.String |
Ce paramètre définit le répertoire contenant les fichiers système du répertoire virtuel. |
TemplateInstance |
Facultatif |
System.Management.Automation.PSObject |
Ce paramètre spécifie que la cmdlet utilise la configuration d'un objet existant, lorsque cet objet est fourni au paramètre, pour dupliquer cet objet sur un serveur local ou cible. |
WebSiteName |
Facultatif |
System.String |
Ce paramètre spécifie le nom du site Web Exchange ActiveSync dans lequel créer le répertoire virtuel. |
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 au paramètre WhatIf, l'administrateur peut afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est $false. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
Exceptions
| Exceptions | Description |
|---|---|
Exemple
L'exemple de code suivant crée un répertoire virtuel sur le serveur Contoso.
New-ActiveSyncVirtualDirectory -Server "Contoso" -WebSiteName "Default Web Site" -ExternalURL "https://www.contoso.com/Microsoft-Server-ActiveSync"