Update-MailboxDatabaseCopy

La cmdlet est disponible uniquement dans Exchange en local.

La cmdlet Update-MailboxDatabaseCopy permet d'amorcer ou de réamorcer une copie de base de données de boîtes aux lettres.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Update-MailboxDatabaseCopy
      [-Identity] <DatabaseCopyIdParameter>
      [-CancelSeed]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-WhatIf]
      [<CommonParameters>]
Update-MailboxDatabaseCopy
      [-Identity] <DatabaseCopyIdParameter>
      [-BeginSeed]
      [-Force]
      [-Network <DatabaseAvailabilityGroupNetworkIdParameter>]
      [-SecondaryDatabasePartitionOnly]
      [-SourceServer <ServerIdParameter>]
      [-CatalogOnly]
      [-Confirm]
      [-DatabaseOnly]
      [-DeleteExistingFiles]
      [-DomainController <Fqdn>]
      [-ManualResume]
      [-NetworkCompressionOverride <UseDagDefaultOnOff>]
      [-NetworkEncryptionOverride <UseDagDefaultOnOff>]
      [-NoThrottle]
      [-PrimaryDatabasePartitionOnly]
      [-SafeDeleteExistingFiles]
      [-WhatIf]
      [<CommonParameters>]
Update-MailboxDatabaseCopy
      -Server <MailboxServerIdParameter>
      [-MaximumSeedsInParallel <Int32>]
      [-CatalogOnly]
      [-Confirm]
      [-DatabaseOnly]
      [-DeleteExistingFiles]
      [-DomainController <Fqdn>]
      [-ManualResume]
      [-NetworkCompressionOverride <UseDagDefaultOnOff>]
      [-NetworkEncryptionOverride <UseDagDefaultOnOff>]
      [-NoThrottle]
      [-PrimaryDatabasePartitionOnly]
      [-SafeDeleteExistingFiles]
      [-WhatIf]
      [<CommonParameters>]

Description

L'amorçage est un processus au cours duquel une copie de base de données de boîtes aux lettres est ajoutée à un autre serveur de boîtes aux lettres. Cela devient la copie de la base de données dans laquelle les fichiers de journaux et les données copiés sont relus.

La cmdlet Update-MailboxDatabaseCopy peut également être utilisée pour amorcer un catalogue d’indexation de contenu pour une copie de base de données de boîtes aux lettres. Lorsque vous effectuez cette opération, le réseau MAPI est utilisé, quelle que soit la valeur que vous spécifiez pour le paramètre Network.

Vous devez suspendre une copie de base de données avant de la mettre à jour à l'aide de la cmdlet Update-MailboxDatabaseCopy. Pour obtenir des instructions détaillées sur la façon de suspendre une copie de base de données, consultez Suspendre ou reprendre une copie de base de données de boîtes aux lettres.

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

Update-MailboxDatabaseCopy -Identity DB1\MBX1

Cet exemple amorce une copie de base de données DB1 sur le serveur de boîtes aux lettres nommé MBX1.

Exemple 2

Update-MailboxDatabaseCopy -Identity DB1\MBX1 -SourceServer MBX2

Cet exemple amorce une copie de base de données DB1 sur le serveur de boîtes aux lettres nommé MBX1 à l'aide de MBX2 comme serveur de boîtes aux lettres source pour l'amorçage.

Exemple 3

Update-MailboxDatabaseCopy -Identity DB1\MBX1 -DatabaseOnly

Cet exemple amorce une copie de base de données DB1 sur le serveur de boîtes aux lettres nommé MBX1 sans amorcer le catalogue d'indexation de contenu.

Exemple 4

Update-MailboxDatabaseCopy -Identity DB1\MBX1 -CatalogOnly

Cet exemple amorce le catalogue d’indexation de contenu pour la copie de base de données DB1 sur le serveur de boîtes aux lettres MBX1 sans amorcer le fichier de base de données. L’amorçage du catalogue d’indexation de contenu se produit sur le réseau MAPI.

Exemple 5

Update-MailboxDatabaseCopy -Server MBX1

Cet exemple exécute un réamorçage de serveur complet de toutes les bases de données situées sur le serveur de boîtes aux lettres MBX1.

Paramètres

-BeginSeed

Le commutateur BeginSeed démarre de façon asynchrone l’opération d’amorçage, puis quitte l’applet de commande. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur est utile pour générer des scripts de réinsédation.

Type:SwitchParameter
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

-CancelSeed

Le commutateur CancelSeed spécifie s'il faut annuler une opération d'amorçage en cours. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CatalogOnly

Le commutateur CatalogOnly spécifie que seul le catalogue d’index de contenu pour la copie de base de données doit être initialisé. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
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

-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

-DatabaseOnly

Le commutateur DatabaseOnly spécifie que seule la copie de base de données doit être amorcée. Le catalogue d'indexation de contenu n'est pas amorcé. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
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

-DeleteExistingFiles

Le commutateur DeleteExistingFiles spécifie s'il faut supprimer les fichiers journaux existants à l'emplacement cible. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Ce commutateur supprime uniquement les fichiers qu’il recherche et échoue si d’autres fichiers sont présents. Aucune mesure n'est prise pour les autres fichiers se trouvant à l'emplacement cible. C'est pourquoi, si d'autres fichiers de la base de données sont disponibles, vous devez les supprimer manuellement.

Type:SwitchParameter
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

-Force

Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.

Type:SwitchParameter
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

-Identity

Le paramètre Identity spécifie le nom ou GUID de la base de données de boîtes aux lettres dont la copie est en cours d'amorçage.

Type:DatabaseCopyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ManualResume

Le commutateur ManualResume spécifie s'il faut reprendre automatiquement la réplication sur la copie de la base de données. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Avec ce commutateur, vous pouvez reprendre manuellement la réplication vers la copie de base de données.

Type:SwitchParameter
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

-MaximumSeedsInParallel

Le paramètre MaximumSeedsInParallel est utilisé avec le paramètre Server pour indiquer le nombre maximal d'opérations d'amorçage parallèles qui doivent être effectuées sur le serveur spécifié lors d'une opération de réamorçage de serveur complet. La valeur par défaut est 10.

Type:Int32
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

-Network

Le paramètre Network spécifie les réseaux DAG à utiliser pour l’amorçage. L’amorçage de catalogue d’indexation de contenu se produit toujours sur le réseau MAPI, même si vous utilisez ce paramètre pour spécifier le réseau DAG.

Type:DatabaseAvailabilityGroupNetworkIdParameter
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

-NetworkCompressionOverride

Le paramètre NetworkCompressionOverride spécifie s'il faut remplacer les paramètres de compression de réseau DAG actuels.

Type:UseDagDefaultOnOff
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

-NetworkEncryptionOverride

Le paramètre NetworkEncryptionOverride spécifie s'il faut remplacer les paramètres de chiffrement DAG actuels.

Type:UseDagDefaultOnOff
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

-NoThrottle

Le commutateur NoThrottle empêche la limitation de l’opération d’amorçage. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-PrimaryDatabasePartitionOnly

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019

-SafeDeleteExistingFiles

Le commutateur SafeDeleteExistingFiles spécifie une opération d’amorçage avec une seule vérification de redondance de copie avant la valeur initiale. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Étant donné que ce commutateur inclut la vérification de sécurité de la redondance, il nécessite un niveau d’autorisations inférieur au paramètre DeleteExistingFiles. Les administrateurs d’autorisations limitées peuvent effectuer l’opération d’amorçage à l’aide de ce commutateur.

Type:SwitchParameter
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

-SecondaryDatabasePartitionOnly

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2019

-Server

Le paramètre Server est utilisé dans le cadre d'une opération de réamorçage de serveur complet. Il peut être utilisé avec le paramètre MaximumSeedsInParallel pour démarrer le réamorçage de copies de bases de données en parallèle sur le serveur spécifié, en lots dont le nombre maximal est la valeur des copies du paramètre MaximumSeedsInParallel en une fois.

Type:MailboxServerIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceServer

Le paramètre SourceServer spécifie le serveur de boîtes aux lettres avec une copie passive de la base de données de boîtes aux lettres à utiliser comme source pour l’opération initiale.

Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom
  • FQDN
  • Nom unique
  • ExchangeLegacyDN
Type:ServerIdParameter
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

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.