New-DatabaseAvailabilityGroup
La cmdlet est disponible uniquement dans Exchange en local.
La cmdlet New-DatabaseAvailabilityGroup permet de créer un groupe de disponibilité de base de données (DAG).
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
New-DatabaseAvailabilityGroup
[-Name] <String>
[-ActivityState <ActivityStateOption>]
[-Confirm]
[-DagConfiguration <DatabaseAvailabilityGroupConfigurationIdParameter>]
[-DatabaseAvailabilityGroupIpAddresses <IPAddress[]>]
[-DomainController <Fqdn>]
[-FileSystem <FileSystemMode>]
[-ThirdPartyReplication <ThirdPartyReplicationMode>]
[-WhatIf]
[-WitnessDirectory <NonRootLocalLongFullPath>]
[-WitnessServer <FileShareWitnessServerName>]
[<CommonParameters>]
Description
Lors de la création d’un DAG, vous devez spécifier un nom d’ordinateur valide pour le DAG ne dépassant pas 15 caractères qui est unique dans la forêt Active Directory. En outre, chaque groupe de disponibilité de base de données est configuré avec un serveur et un répertoire témoins. Le serveur témoin et son répertoire ne sont utilisés qu’à des fins de quorum avec un nombre pair de membres dans le groupe de disponibilité de base de données. Il n'est pas nécessaire de créer le répertoire témoin à l'avance. Exchange crée et sécurise automatiquement le répertoire pour vous sur le serveur témoin. Le répertoire ne doit pas être utilisé pour autre chose que le serveur DAG témoin.
La configuration requise pour le serveur témoin est la suivante :
- Le serveur témoin ne peut pas être membre DAG.
- Le serveur témoin doit exécuter le système d’exploitation Windows Server 2008 ou version ultérieure.
- Un serveur unique peut servir de témoin pour plusieurs groupes de disponibilité de base de données. Toutefois, chaque DAG requiert son propre répertoire témoin.
Les combinaisons suivantes de comportements et d’options sont disponibles :
- Vous pouvez donner un nom au groupe de disponibilité de base de données, au serveur témoin que vous souhaitez utiliser et au répertoire qui sera créé et partagé sur le serveur témoin.
- Vous pouvez donner un nom au groupe de disponibilité de base de données et au serveur témoin que vous souhaitez utiliser. Dans ce scénario, l’opération consiste à créer le répertoire par défaut sur le serveur témoin spécifié.
Si le serveur témoin que vous spécifiez n’est pas un serveur Exchange, vous devez ajouter le groupe de sécurité universel (USG) du sous-système approuvé Exchange au groupe Administrateurs local sur le serveur témoin. Si le serveur témoin est un serveur d’annuaire, vous devez ajouter le groupe usg du sous-système approuvé Exchange au groupe Builtin\Administrators. Ces autorisations de sécurité sont nécessaires pour garantir que Exchange peut créer un répertoire et un partage sur le serveur témoin au besoin.
Dans Windows Server 2012 R2 ou version ultérieure, un DAG est créé sans point d’accès administratif de cluster par défaut. Dans ce scénario, vous n’avez pas besoin de fournir des adresses IP au DAG. Toutefois, dans toutes les versions prises en charge de Windows, vous avez la possibilité d’affecter des adresses IP statiques au DAG à l’aide du paramètre DatabaseAvailabilityGroupIpAddresses. Si vous spécifiez Tout ou 0.0.0.0, la tâche tente d’utiliser le protocole DHCP (Dynamic Host Configuration Protocol) pour obtenir des adresses IP. Si vous omettez ce paramètre ou que vous configurez le paramètre avec une valeur Aucune ou 255.255.255.255, le DAG n’aura pas de point d’accès administratif de cluster.
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
New-DatabaseAvailabilityGroup -Name DAG1 -WitnessServer SERVER1 -WitnessDirectory C:\DAG1
Cet exemple crée un groupe de disponibilité de base de données (DAG) nommé DAG1, configuré pour utiliser un serveur témoin de SERVER1 et un répertoire local C:\DAG1. Cet exemple nécessite Windows Server 2012 R2 ou version ultérieure.
Exemple 2
New-DatabaseAvailabilityGroup -Name DAG2 -WitnessServer SERVER2 -DatabaseAvailabilityGroupIpAddresses ([])::Any
Cet exemple crée le DAG nommé DAG2 avec un serveur témoin nommé SERVER2. Le système sélectionne automatiquement un serveur Exchange dans le même site que le DAG à utiliser comme serveur témoin. DAG1 est également configuré pour utiliser le protocole DHCP pour l’adresse IP du groupe de disponibilité de base de données.
Exemple 3
New-DatabaseAvailabilityGroup -Name DAG3 -WitnessServer SERVER1 -WitnessDirectory C:\DAG3 -DatabaseAvailabilityGroupIpAddresses 10.0.0.8,192.168.0.8
Cet exemple crée un groupe de disponibilité de base de données nommé DAG3. DAG3 est configuré pour utiliser SERVER1 pour le serveur témoin et un répertoire témoin C:\DAG3 sur SERVER1. On attribue plusieurs adresses IP statiques à DAG3, car le réseau est susceptible d’intégrer plusieurs sous-réseaux (10.0.0.x et 192.168.0.x).
Paramètres
-ActivityState
Ce paramètre est réservé à l’usage interne chez Microsoft.
Type: | ActivityStateOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DagConfiguration
Ce paramètre est réservé à l’usage interne chez Microsoft.
Type: | DatabaseAvailabilityGroupConfigurationIdParameter |
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 |
-DatabaseAvailabilityGroupIpAddresses
Le paramètre DatabaseAvailabilityGroupIpAddresses spécifie une ou plusieurs adresses IPv4 statiques au groupe de disponibilité de base de données lorsqu’un serveur de boîtes aux lettres est ajouté à ce dernier. Si vous spécifiez la valeur Any ou 0.0.0.0, le système tente de louer une ou plusieurs adresses IPv4 à partir d’un serveur DHCP à attribuer au DAG. Si vous n’utilisez pas ce paramètre, ou si vous spécifiez la valeur 255.255.255.255 ou Aucun, le DAG est créé sans point d’accès administratif de cluster.
Type: | IPAddress[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-FileSystem
Le paramètre FileSystem spécifie le système de fichiers utilisé pour le DAG. Les valeurs valides sont les suivantes :
- NTFS
- Refs
Type: | FileSystemMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Name
Le paramètre Name spécifie un nom unique pour le nouveau groupe de disponibilité de base de données pouvant contenir jusqu’à 15 caractères. Le nom employé ne doit pas entrer en conflit avec le nom d’un ordinateur dans l’organisation.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ThirdPartyReplication
Le paramètre ThirdPartyReplication spécifie de configurer et d’activer un DAG pour utiliser la réplication tierce qui tire parti de l’API de réplication tierce Exchange au lieu de la réplication continue intégrée. Les valeurs valides sont Enabled et Disabled. Une fois ce mode activé,vous ne pouvez pas le désactiver.
Type: | ThirdPartyReplicationMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WitnessDirectory
Le paramètre WitnessDirectory spécifie le nom du répertoire sur le serveur témoin qui sert à stocker les données du témoin de partage de fichiers. Le répertoire et le partage doivent être hébergés sur un serveur Exchange autre que les serveurs de boîtes aux lettres dans le DAG. Cela permet à un administrateur Exchange de conserver un contrôle opérationnel sur l’annuaire. Le répertoire spécifié ne peut pas être utilisé par d’autres groupes de disponibilité de base de données ou pour un autre usage que celui du serveur témoin. Si vous n’utilisez pas ce paramètre, le répertoire témoin par défaut est utilisé.
Type: | NonRootLocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WitnessServer
Le paramètre WitnessServer spécifie le nom du serveur employé comme témoin de quorum lorsque le DAG contient un nombre de membres équivalent. Le serveur spécifié ne peut pas être membre du groupe de disponibilité de base de données configuré pour l’utiliser. Un serveur de boîtes aux lettres autonome ou se trouvant dans un autre groupe de disponibilité de base de données est recommandé.
Type: | FileShareWitnessServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, 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.