Applies to: Exchange Server 2013

Topic Last Modified: 2013-01-02

Use the Set-DatabaseAvailabilityGroup cmdlet to configure properties of a database availability group (DAG).

For information about the parameter sets in the Syntax section below, see Syntax.

Syntax


Set-DatabaseAvailabilityGroup -Identity <DatabaseAvailabilityGroupIdParameter> [-AllowCrossSiteRpcClientAccess <SwitchParameter>] [-AlternateWitnessDirectory <NonRootLocalLongFullPath>] [-AlternateWitnessServer <FileShareWitnessServerName>] [-AutoDagAllServersInstalled <$true \| $false>] [-AutoDagDatabaseCopiesPerDatabase <Int32>] [-AutoDagDatabaseCopiesPerVolume <Int32>] [-AutoDagDatabasesRootFolderPath <NonRootLocalLongFullPath>] [-AutoDagFailedVolumesRootFolderPath <NonRootLocalLongFullPath>] [-AutoDagTotalNumberOfDatabases <Int32>] [-AutoDagTotalNumberOfServers <Int32>] [-AutoDagVolumesRootFolderPath <NonRootLocalLongFullPath>] [-Confirm [<SwitchParameter>]] [-DatabaseAvailabilityGroupIpAddresses <IPAddress[]>] [-DatacenterActivationMode <Off \| DagOnly>] [-DiscoverNetworks <SwitchParameter>] [-DomainController <Fqdn>] [-ManualDagNetworkConfiguration <$true \| $false>] [-NetworkCompression <Disabled \| Enabled \| InterSubnetOnly \| SeedOnly>] [-NetworkEncryption <Disabled \| Enabled \| InterSubnetOnly \| SeedOnly>] [-ReplayLagManagerEnabled <$true \| $false>] [-ReplicationPort <UInt16>] [-SkipDagValidation <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-WitnessDirectory <NonRootLocalLongFullPath>] [-WitnessServer <FileShareWitnessServerName>]

Set-DatabaseAvailabilityGroup -Identity
<DatabaseAvailabilityGroupIdParameter>
[-AllowCrossSiteRpcClientAccess <SwitchParameter>]
[-AlternateWitnessDirectory <NonRootLocalLongFullPath>]
[-AlternateWitnessServer <FileShareWitnessServerName>]
[-AutoDagAllServersInstalled <$true | $false>]
[-AutoDagDatabaseCopiesPerDatabase <Int32>]
[-AutoDagDatabaseCopiesPerVolume <Int32>]
[-AutoDagDatabasesRootFolderPath <NonRootLocalLongFullPath>]
[-AutoDagFailedVolumesRootFolderPath
<NonRootLocalLongFullPath>] [-AutoDagTotalNumberOfDatabases
<Int32>] [-AutoDagTotalNumberOfServers <Int32>]
[-AutoDagVolumesRootFolderPath <NonRootLocalLongFullPath>]
[-Confirm [<SwitchParameter>]]
[-DatabaseAvailabilityGroupIpAddresses <IPAddress[]>]
[-DatacenterActivationMode <Off | DagOnly>]
[-DiscoverNetworks <SwitchParameter>] [-DomainController
<Fqdn>] [-ManualDagNetworkConfiguration <$true |
$false>] [-NetworkCompression <Disabled | Enabled |
InterSubnetOnly | SeedOnly>] [-NetworkEncryption <Disabled |
Enabled | InterSubnetOnly | SeedOnly>] [-ReplayLagManagerEnabled
<$true | $false>] [-ReplicationPort <UInt16>]
[-SkipDagValidation <SwitchParameter>] [-WhatIf
[<SwitchParameter>]] [-WitnessDirectory
<NonRootLocalLongFullPath>] [-WitnessServer
<FileShareWitnessServerName>]

Examples

EXAMPLE 1

This example sets the witness directory to C:\DAG1DIR for the DAG DAG1.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -WitnessDirectory C:\DAG1DIR

EXAMPLE 2

This example preconfigures an alternate witness server of CAS3 and an alternate witness directory of C:\DAGFileShareWitnesses\DAG1.contoso.com for the DAG DAG1.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -AlternateWitnessDirectory C:\DAGFileShareWitnesses\DAG1.contoso.com -AlternateWitnessServer CAS3

EXAMPLE 3

This example configures the DAG DAG1 to use DHCP to obtain an IP address.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatabaseAvailabilityGroupIpAddresses 0.0.0.0

EXAMPLE 4

This example configures the DAG DAG1 to use a static IP address of 10.0.0.8.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatabaseAvailabilityGroupIpAddresses 10.0.0.8

EXAMPLE 5

This example configures the multi-subnet DAG DAG1 with multiple static IP addresses.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatabaseAvailabilityGroupIpAddresses 10.0.0.8,10.0.1.8

EXAMPLE 6

This example configures TCP port 63132 as the port used by replication for the DAG DAG1.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -ReplicationPort 63132

Note:
After changing the default replication port for a DAG, you must manually modify the Windows Firewall exceptions on each member of the DAG to allow communication to occur over the specified port.

EXAMPLE 7

This example configures the DAG DAG1 for DAC mode.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatacenterActivationMode DagOnly

EXAMPLE 8

This example configures the DAG DAG1 for AutoReseed using custom mount point paths and 4 databases per volume.

	Copy Code
Set-DatabaseAvailabilityGroup -Identity DAG1 -AutoDagVolumesRootFolderPath C:\ExchVols -AutoDagDatabasesRootFolderPath C:\ExchDBs -AutoDagDatabaseCopiesPerVolume 4

Detailed Description

The Set-DatabaseAvailabilityGroup cmdlet enables you to manage DAG properties that can't be managed from the Exchange Administration Center (EAC), such as configuring network discovery, selecting the TCP port used for replication, and enabling datacenter activation coordination (DAC) mode.

DAG property values are stored in both Active Directory and the cluster database. Because some properties are stored in the cluster database, the underlying cluster for the DAG must have quorum to set the properties for:

ReplicationPort
NetworkCompression
NetworkEncryption
DiscoverNetworks

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the"Database availability groups" entry in the High Availability and Site Resilience Permissions topic.

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.DatabaseAvailabilityGroupIdParameter	The Identity parameter specifies the name of the DAG to be modified.
AllowCrossSiteRpcClientAccess	Optional	System.Management.Automation.SwitchParameter	This parameter is reserved for internal Microsoft use.
AlternateWitnessDirectory	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The AlternateWitnessDirectory parameter specifies the name of an alternate directory that's used to store file share witness data. The specified directory must not be in use by any other DAGs or used for any other purpose. This parameter is used only as part of a datacenter switchover process. If the DAG is extended across multiple datacenters in a site resilience configuration, we recommend preconfiguring the alternate witness server and directory.
AlternateWitnessServer	Optional	Microsoft.Exchange.Data.FileShareWitnessServerName	The AlternateWitnessServer parameter specifies the name of an alternate server that's used to store file share witness data. The specified server must not be a member of the DAG that's configured to use it. This parameter is used only as part of a datacenter switchover process. If the DAG is extended across multiple datacenters in a site resilience configuration, we recommend preconfiguring the alternate witness server and directory.
AutoDagAllServersInstalled	Optional	System.Boolean	This parameter is reserved for internal Microsoft use.
AutoDagDatabaseCopiesPerDatabase	Optional	System.Int32	This parameter is reserved for internal Microsoft use.
AutoDagDatabaseCopiesPerVolume	Optional	System.Int32	The AutoDagDatabaseCopiesPerVolume parameter is used to specify the configured number of database copies per volume. This parameter is used only with the AutoReseed feature of the DAG.
AutoDagDatabasesRootFolderPath	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The AutoDagDatabasesRootFolderPath parameter specifies the directory containing the database mount points when using the AutoReseed feature of the DAG. This parameter is required when using AutoReseed. AutoReseed uses a default path of C:\ExchangeDatabases.
AutoDagFailedVolumesRootFolderPath	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	This parameter is reserved for internal Microsoft use.
AutoDagTotalNumberOfDatabases	Optional	System.Int32	This parameter is reserved for internal Microsoft use.
AutoDagTotalNumberOfServers	Optional	System.Int32	This parameter is reserved for internal Microsoft use.
AutoDagVolumesRootFolderPath	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The AutoDagVolumesRootFolderPath parameter specifies the volume containing the mount points for all disks, including spare disks, when using the AutoReseed feature of the DAG. This parameter is required when using AutoReseed. AutoReseed uses a default path of C:\ExchangeVolumes.
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm switch.
DatabaseAvailabilityGroupIpAddresses	Optional	System.Net.IPAddress[]	The DatabaseAvailabilityGroupIpAddresses parameter specifies one or more static IP addresses to the DAG when a Mailbox server is added to a DAG. If you omit the DatabaseAvailabilityGroupIpAddresses parameter when creating a DAG, the system attempts to lease one or more IP addresses from a Dynamic Host Configuration Protocol (DHCP) server in your organization to assign to the DAG. You must specify this parameter each time an additional IP address is added to the DAG, such as in the case of multi-subnet DAGs. You must also specify all IP addresses previously assigned to the DAG each time the DatabaseAvailabilityGroupIpAddresses parameter is used. Setting the DatabaseAvailabilityGroupIpAddresses parameter to a value of `0.0.0.0` automatically configures the DAG to use DHCP.
DatacenterActivationMode	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DatacenterActivationModeOption	The DatacenterActivationMode parameter specifies whether datacenter activation mode is disabled (`Off`) or enabled for the DAG (`DagOnly`).
DiscoverNetworks	Optional	System.Management.Automation.SwitchParameter	The DiscoverNetworks parameter specifies whether to force a rediscovery of the network and network interfaces. By default, internal network heartbeats are sent between DAG members on the same subnet. If there's no response to the heartbeats, network discovery is performed automatically by the system. If you add or remove networks or change DAG network subnets, you can force rediscovery of all DAG networks by using the DiscoverNetworks parameter.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.
ManualDagNetworkConfiguration	Optional	System.Boolean	The ManualDagNetworkConfiguration parameter specifies whether DAG networks should be automatically configured. If this parameter is set to False, DAG networks are automatically configured. If this parameter is set to True, you must manually configure DAG networks.
NetworkCompression	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DatabaseAvailabilityGroup+NetworkOption	The NetworkCompression parameter specifies whether network compression is disabled on all networks (`Disabled`), enabled on all networks (`Enabled`), enabled for inter-subnet communication only (`InterSubnetOnly`), or enabled only for seeding (`SeedOnly`).
NetworkEncryption	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.DatabaseAvailabilityGroup+NetworkOption	The NetworkEncryption parameter specifies whether network encryption is disabled on all networks (`Disabled`), enabled on all networks (`Enabled`), enabled for inter-subnet communication only (`InterSubnetOnly`), or enabled only for seeding (`SeedOnly`).
ReplayLagManagerEnabled	Optional	System.Boolean	The ReplayLagManagerEnabled parameter specifies whether to disable the automatic playdown of log files for a lagged database copy.
ReplicationPort	Optional	System.UInt16	The ReplicationPort parameter specifies a Transmission Control Protocol (TCP) port for replication (log shipping and seeding) activity. If this parameter isn't specified, the default port for replication is TCP 64327.
SkipDagValidation	Optional	System.Management.Automation.SwitchParameter	The SkipDagValidation switch specifies whether to bypass the validation of the DAG's quorum model and the health check on the DAG's witness when configuring the DAG.
WhatIf	Optional	System.Management.Automation.SwitchParameter	The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf switch.
WitnessDirectory	Optional	Microsoft.Exchange.Data.NonRootLocalLongFullPath	The WitnessDirectory parameter specifies the name of the directory on the server that's used to store file share witness data. The specified directory must not be in use by any other DAGs.
WitnessServer	Optional	Microsoft.Exchange.Data.FileShareWitnessServerName	The WitnessServer parameter specifies the name of a server that will act as a witness for the DAG. The server specified can't be a member of the DAG.

Input Types

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

Return Types

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.