Refreshes the database copy map on an Exchange database availability group (DAG) provisioned with ESI.
Syntax
Update-EmcHAExtension [-DatabaseAvailabilityGroup] <DatabaseAvailabilityGroup> [-Silent] [<CommonParameters>]
Description
The ESI Exchange HA Extension component must be installed on each mailbox server in the DAG. The extension handles database failover and switchover operations on Exchange databases that have been provisioned using ESI. To do this, the HA Extension relies on an internal table called the database copy map, which associates the database copies in the DAG with the corresponding storage system and replication components. This command triggers an update of the database copy map so that it contains a current view of the database copies and related components.
This command can be used together with the Disable-EmcExchangeFailover and Enable-EmcExchangeFailover cmdlets to prepare a database for failover operations. The example shows how to do this.
Parameters
-DatabaseAvailabilityGroup <DatabaseAvailabilityGroup>
Attributes: Required, Position: 1
Specifies the DAG on which to refresh the database copy map.
-Silent <SwitchParameter>
Attributes: Optional, Position: named
Turns off all the informational and verbose messages. However, it still displays errors.
<CommonParameters>
This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.
C:\PS>$dag = Get-EmcDatabaseAvailabilityGroup MyDAG
C:\PS>Disable-EmcExchangeFailover $dag
# Before invoking the next command the Administrator should create databases and database copies in the DAG
C:\PS>Update-EmcHAExtension $dag
C:\PS>Enable-EmcExchangeFailover $dag
This example updates or refreshes the extension by disabling the failover on the MyDAG DAG, updating the database copy map, and then re-enabling the failover.