New-OabVirtualDirectory
La cmdlet est disponible uniquement dans Exchange en local.
Utilisez l’applet de commande New-OABVirtualDirectory pour créer des répertoires virtuels de carnet d’adresses en mode hors connexion (OAB) qui sont utilisés dans Internet Information Services (IIS) sur des serveurs Microsoft Exchange. Le répertoire virtuel OAB configure le serveur en tant que point de distribution web pour un carnet d’adresses en mode hors connexion. En règle générale, vous créez des répertoires virtuels sur des serveurs Exchange sur lesquels le rôle serveur d’accès au client est installé.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
New-OabVirtualDirectory
[-Confirm]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalUrl <Uri>]
[-InternalUrl <Uri>]
[-Path <String>]
[-PollInterval <Int32>]
[-Recovery]
[-RequireSSL <Boolean>]
[-Role <VirtualDirectoryRole>]
[-Server <ServerIdParameter>]
[-WebSiteName <String>]
[-WhatIf]
[<CommonParameters>]
Description
L’applet de commande New-OABVirtualDirectory configure un point de distribution web pour un carnet d’adresses en mode hors connexion et crée le répertoire virtuel OAB.
Vous devez créer manuellement le dossier du système de fichiers sur le serveur qui héberge les fichiers OAB.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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
New-OABVirtualDirectory -Server CASServer01 -PollInterval 120
Cet exemple crée un répertoire virtuel de carnet d’adresses en mode hors connexion sur CASServer01 et configure le service de distribution pour interroger le serveur de génération toutes les deux heures.
Paramètres
-Confirm
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. La façon dont ce commutateur affecte l’applet de commande varie selon que l’applet de commande nécessite ou non une confirmation avant de continuer.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 ».
Propriétés du paramètre
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExtendedProtectionFlags
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre ExtendedProtectionFlags spécifie des paramètres personnalisés pour la protection étendue pour l’authentification sur le répertoire virtuel. Les valeurs valides sont les suivantes :
- Aucune : paramètre par défaut.
- AllowDotlessSPN : obligatoire si vous souhaitez utiliser des valeurs de nom de principal du service (SPN) qui ne contiennent pas de noms de domaine complets (par exemple, HTTP/ContosoMail au lieu de HTTP/mail.contoso.com). Vous spécifiez des SPN avec le paramètre ExtendedProtectionSPNList. Ce paramètre rend la protection étendue pour l’authentification moins sécurisée, car les certificats sans point ne sont pas uniques. Il n’est donc pas possible de s’assurer que la connexion client à proxy a été établie sur un canal sécurisé.
- NoServiceNameCheck : la liste SPN n’est pas vérifiée pour valider un jeton de liaison de canal. Ce paramètre rend la protection étendue pour l’authentification moins sécurisée. Ce paramètre n’est généralement pas recommandé.
- Proxy : un serveur proxy est responsable de l’arrêt du canal TLS. Pour utiliser ce paramètre, vous devez inscrire un SPN à l’aide du paramètre ExtendedProtectionSPNList.
- ProxyCoHosting : le trafic HTTP et HTTPS peut accéder au répertoire virtuel, et un serveur proxy se trouve entre au moins certains clients et les services d’accès au client sur le serveur Exchange.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExtendedProtectionSPNList
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre ExtendedProtectionSPNList spécifie une liste de noms de principal de service (SPN) valides si vous utilisez la protection étendue pour l’authentification sur le répertoire virtuel. Les valeurs valides sont les suivantes :
- $null : cette valeur est la valeur par défaut.
- SpN unique ou liste délimitée par des virgules de SPN valides : le format de valeur SPN est
Protocol\FQDN. Par exemple, HTTP/mail.contoso.com. Pour ajouter un SPN qui n’est pas un nom de domaine complet (par exemple, HTTP/ContosoMail), vous devez également utiliser la valeur AllowDotlessSPN pour le paramètre ExtendedProtectionFlags.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExtendedProtectionTokenChecking
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre ExtendedProtectionTokenChecking spécifie si la protection étendue pour l’authentification est utilisée pour les connexions clientes au répertoire virtuel. Les valeurs valides sont les suivantes :
- Aucun : la protection étendue pour l’authentification n’est pas utilisée pour les connexions clientes au répertoire virtuel. Cette valeur est la valeur par défaut.
- Autoriser : la protection étendue pour l’authentification est utilisée pour les connexions client au répertoire virtuel si le client et le serveur le prennent en charge.
- Exiger : une protection étendue pour l’authentification est requise pour les connexions clientes au répertoire virtuel. Si le client ou le serveur ne le prend pas en charge, la connexion échoue. Cette valeur nécessite également une valeur de nom de principal du service (SPN) pour le paramètre ExtendedProtectionSPNList.
Remarque : Si un serveur proxy devant le serveur Exchange met fin au canal TLS (Transport Layer Security) client-à-proxy, les valeurs Allow ou Require nécessitent une ou plusieurs valeurs SPN pour le paramètre ExtendedProtectionSPNList.
Propriétés du paramètre
| Type: | ExtendedProtectionTokenCheckingMode |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExternalUrl
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre ExternalURL spécifie l’URL qui se connecte au répertoire virtuel à partir de l’extérieur du pare-feu.
Propriétés du paramètre
| Type: | Uri |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InternalUrl
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre InternalURL spécifie l’URL qui se connecte au répertoire virtuel à partir du pare-feu.
Propriétés du paramètre
| Type: | Uri |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Path
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre Path spécifie le chemin du système de fichiers du répertoire virtuel. Il est recommandé d’utiliser ce paramètre uniquement lorsque vous avez besoin d’utiliser un emplacement personnalisé pour les fichiers du répertoire virtuel. La valeur par défaut est vide ($null), ce qui indique que l’emplacement par défaut est utilisé.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PollInterval
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre PollInterval spécifie l’intervalle de temps en minutes pendant lequel le service de distribution interroge le serveur de génération de carnet d’adresses hors connexion pour les mises à jour. La valeur par défaut est 480 minutes (8 heures).
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Recovery
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RequireSSL
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre RequireSSL spécifie si les connexions clientes au répertoire virtuel nécessitent un chiffrement TLS (Transport Layer Security). Les valeurs valides sont les suivantes :
- $true : le chiffrement TLS est requis pour se connecter au répertoire virtuel. Cette valeur est la valeur par défaut.
- $false : le chiffrement TLS n’est pas nécessaire pour se connecter au répertoire virtuel.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Role
Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre Role correspond à la configuration du répertoire virtuel. Les valeurs valides sont les suivantes :
- ClientAccess : configurez le répertoire virtuel pour les services d’accès au client (frontend) sur le serveur de boîtes aux lettres.
- Boîte aux lettres : configurez le répertoire virtuel pour les services principaux sur le serveur de boîtes aux lettres.
Les connexions clientes sont transmises par proxy des services d’accès au client vers les services principaux sur les serveurs de boîtes aux lettres locaux ou distants. Les clients ne se connectent pas directement aux services principaux.
Propriétés du paramètre
| Type: | VirtualDirectoryRole |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Server
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre Server spécifie le serveur Exchange qui héberge le répertoire virtuel. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :
- Nom
- FQDN
- Nom unique
- ExchangeLegacyDN
Propriétés du paramètre
| Type: | ServerIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-WebSiteName
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le paramètre WebSiteName spécifie le nom du site web IIS dans lequel le répertoire virtuel est créé. Vous n’avez pas besoin d’utiliser ce paramètre pour créer le répertoire virtuel dans le site web par défaut.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Le commutateur WhatIf montre ce que fait la commande sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.