Set-DatabaseAvailabilityGroup
內部部署 Exchange 才有提供此 Cmdlet。
使用 Set-DatabaseAvailabilityGroup 指令程式,可設定資料庫可用性群組 (DAG) 的內容。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Set-DatabaseAvailabilityGroup
[-Identity] <DatabaseAvailabilityGroupIdParameter>
[-ActivityState <ActivityStateOption>]
[-AllowCrossSiteRpcClientAccess]
[-AlternateWitnessDirectory <NonRootLocalLongFullPath>]
[-AlternateWitnessServer <FileShareWitnessServerName>]
[-AutoDagAllServersInstalled <Boolean>]
[-AutoDagAutoRedistributeEnabled <Boolean>]
[-AutoDagAutoReseedEnabled <Boolean>]
[-AutoDagBitlockerEnabled <Boolean>]
[-AutoDagDatabaseCopiesPerDatabase <Int32>]
[-AutoDagDatabaseCopiesPerVolume <Int32>]
[-AutoDagDatabasesRootFolderPath <NonRootLocalLongFullPath>]
[-AutoDagDiskReclaimerEnabled <Boolean>]
[-AutoDagTotalNumberOfDatabases <Int32>]
[-AutoDagTotalNumberOfServers <Int32>]
[-AutoDagVolumesRootFolderPath <NonRootLocalLongFullPath>]
[-Confirm]
[-DagConfiguration <DatabaseAvailabilityGroupConfigurationIdParameter>]
[-DatabaseAvailabilityGroupIpAddresses <IPAddress[]>]
[-DatacenterActivationMode <DatacenterActivationModeOption>]
[-DiscoverNetworks]
[-DomainController <Fqdn>]
[-FileSystem <FileSystemMode>]
[-ManualDagNetworkConfiguration <Boolean>]
[-MetaCacheDatabaseVolumesPerServer <Int32>]
[-NetworkCompression <NetworkOption>]
[-NetworkEncryption <NetworkOption>]
[-PreferenceMoveFrequency <TimeSpan>]
[-ReplayLagManagerEnabled <Boolean>]
[-ReplicationPort <UInt16>]
[-SkipDagValidation]
[-WhatIf]
[-WitnessDirectory <NonRootLocalLongFullPath>]
[-WitnessServer <FileShareWitnessServerName>]
[<CommonParameters>]
Description
Set-DatabaseAvailabilityGroup Cmdlet 可讓您管理無法從 Exchange 系統管理中心 (EAC) 管理的 DAG 屬性,例如設定網路探索、選取用於複寫的 TCP 埠,以及 (DAC) 模式啟用資料中心啟用協調。
DAG 內容值會儲存在 Active Directory 和叢集資料庫中。 由於部分內容儲存於叢集資料庫,DAG 的底層叢集必須有仲裁且屬性設為:
- ReplicationPort
- NetworkCompression
- NetworkEncryption
- DiscoverNetworks
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-DatabaseAvailabilityGroup -Identity DAG1 -WitnessDirectory C:\DAG1DIR
本範例將名為 DAG1 的 DAG 的見證目錄設定為 C:\DAG1DIR。
範例 2
Set-DatabaseAvailabilityGroup -Identity DAG1 -AlternateWitnessDirectory C:\DAGFileShareWitnesses\DAG1.contoso.com -AlternateWitnessServer CAS3
本範例預先設定 DAG DAG1 的替代見證伺服器 CAS3 和替代見證目錄 C:\DAGFileShareWitnesses\DAG1.contoso.com。
範例 3
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatabaseAvailabilityGroupIpAddresses 0.0.0.0
本範例將名為 DAG1 的 DAG 設定為使用 DHCP 以取得 IP 位址。
範例 4
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatabaseAvailabilityGroupIpAddresses 10.0.0.8
本範例將名為 DAG1 的 DAG 設定為使用靜態 IP 位址 10.0.0.8。
範例 5
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatabaseAvailabilityGroupIpAddresses 10.0.0.8,10.0.1.8
本範例以多重靜態 IP 位址設定名為 DAG1 的多重子網路 DAG。
範例 6
Set-DatabaseAvailabilityGroup -Identity DAG1 -ReplicationPort 63132
此範例會將 TCP 通訊埠 63132 設為名為 DAG1 的 DAG 用於複寫的通訊埠。
變更 DAG 的預設複寫通訊埠後,您必須手動修改 DAG 每個成員上的 Windows 防火牆例外狀況,以允許透過指定通訊埠進行通訊。
範例 7
Set-DatabaseAvailabilityGroup -Identity DAG1 -DatacenterActivationMode DagOnly
本範例針對 DAC 模式設定 DAG DAG1。
範例 8
Set-DatabaseAvailabilityGroup -Identity DAG1 -AutoDagVolumesRootFolderPath C:\ExchVols -AutoDagDatabasesRootFolderPath C:\ExchDBs -AutoDagDatabaseCopiesPerVolume 4
此範例會按每個磁碟區使用自訂裝載點路徑及 4 個資料庫,藉以設定 DAG DAG1 for AutoReseed。
參數
-ActivityState
將保留此參數供 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 |
-AllowCrossSiteRpcClientAccess
將保留此參數供 Microsoft 內部使用。
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 |
-AlternateWitnessDirectory
AlternateWitnessDirectory 參數會指定用於儲存檔案共用見證資料的替代目錄名稱。 指定的目錄必須未由任何其他 DAG 使用或是未用於任何其他用途。 此參數只用於資料中心轉換程序。 如果在站台回復性組態中 DAG 遍布多個資料中心,我們建議預先設定替代的見證伺服器和目錄。
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 |
-AlternateWitnessServer
AlternateWitnessServer 參數會指定用於儲存檔案共用見證資料的替代伺服器名稱。 指定的伺服器不得為設定為使用伺服器的 DAG 成員。 此參數只用於資料中心轉換程序。 如果在站台回復性組態中 DAG 遍布多個資料中心,我們建議預先設定替代的見證伺服器和目錄。
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 |
-AutoDagAllServersInstalled
將保留此參數供 Microsoft 內部使用。
Type: | Boolean |
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 |
-AutoDagAutoRedistributeEnabled
AutoDagAutoRedistributeEnabled 參數會指定在 AutoReseed 期間啟用或停用自動 DAG 轉散發。 預設值為 $true (已啟用)。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-AutoDagAutoReseedEnabled
AutoDagAutoReseedEnabled 可用來啟用或停用 Autoreseed。 預設值為 $true (已啟用)。
Type: | Boolean |
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 |
-AutoDagBitlockerEnabled
AutoDagBitlockerEnabled 參數可確保磁片回收器能正確處理備用磁片,並使用 BitLocker 加密它們。 如果使用 Bitlocker 來加密資料庫磁片,請在 DAG 中的所有信箱伺服器全部執行 Exchange 2013 CU13 或更新版本,或 Exchange 2016 CU2 或更新版本之後,將此參數的值設定為在 DAG 中的所有信箱伺服器上$true。
Type: | Boolean |
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 |
-AutoDagDatabaseCopiesPerDatabase
將保留此參數供 Microsoft 內部使用。
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 |
-AutoDagDatabaseCopiesPerVolume
AutoDagDatabaseCopiesPerVolume 參數可用於指定每個磁碟區的已設定資料庫複本數量。 此參數只能搭配 AutoReseed 使用。
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 |
-AutoDagDatabasesRootFolderPath
AutoDagDatabasesRootFolderPath 參數可在使用 AutoReseed 時,指定包含資料庫裝載點的目錄。 使用 AutoReseed 時需要此參數。 AutoReseed 使用預設的 C:\ExchangeDatabases 路徑。
Type: | NonRootLocalLongFullPath |
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 |
-AutoDagDiskReclaimerEnabled
AutoDagDiskReclaimerEnabled 可用來啟用或停用 Autoreseed 所使用的磁碟區格式化功能。 預設值為 $true (已啟用)。 如果設定為 $false,您必須在資料庫可以重新植入前,手動將磁碟區格式化。
Type: | Boolean |
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 |
-AutoDagTotalNumberOfDatabases
將保留此參數供 Microsoft 內部使用。
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 |
-AutoDagTotalNumberOfServers
將保留此參數供 Microsoft 內部使用。
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 |
-AutoDagVolumesRootFolderPath
AutoDagVolumesRootFolderPath 參數會指定當使用 DAG 的 AutoReseed 功能時,包含所有磁碟 (包括備用磁碟) 之裝載點的磁碟區。 使用 AutoReseed 時需要此參數。 AutoReseed 使用預設的 C:\ExchangeVolumes 路徑。
Type: | NonRootLocalLongFullPath |
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 |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false
。 - 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
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
將保留此參數供 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
當 Mailbox Server 新增至 DAG 時,DatabaseAvailabilityGroupIpAddresses 參數會指派一或多個靜態 IP 位址給 DAG。 如果建立 DAG 時省略了 DatabaseAvailabilityGroupIpAddresses 參數,則系統會嘗試向您組織中的動態主機設定通訊協定 (DHCP) 伺服器租用一或多個 IP 位址,以便指派給 DAG。 每當有其他 IP 位址新增至 DAG 時,您就必須指定此參數,例如多重子網路 DAG 的情況。 每次使用 DatabaseAvailabilityGroupIpAddresses 參數時,您也必須指定先前指派給 DAG 的所有 IP 位址。 將 DatabaseAvailabilityGroupIpAddresses 參數的值設定為 0.0.0.0 會自動將 DAG 設定為使用 DHCP。
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 |
-DatacenterActivationMode
DatacenterActivationMode 參數指定 DAG 的資料中心啟動模式。 有效值為:
- 關閉:停用資料中心啟用模式。
- DagOnly:已啟用資料中心啟用模式。
Type: | DatacenterActivationModeOption |
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 |
-DiscoverNetworks
DiscoverNetworks 參數會指定是否要強制重新探索網路和網路介面。 您不需要使用此參數指定值。
依預設,內部網路活動訊號會在位於相同子網路的 DAG 成員之間傳送。 如果對活動訊號沒有回應,系統就會自動執行網路探索。 如果您新增或移除網路或變更 DAG 網路子網,您可以使用 DiscoverNetworks 參數強制重新探索所有 DAG 網路。
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
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,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
FileSystem 參數會指定用於 DAG 的檔案系統。 有效值為:
- Ntfs
- 裁判
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 |
-Identity
Identity 參數指定您要修改 DAG 的名稱。
Type: | DatabaseAvailabilityGroupIdParameter |
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 |
-ManualDagNetworkConfiguration
ManualDagNetworkConfiguration參數會指定是否應自動設定 DAG 網路。 若將此參數設為 $false,會自動設定 DAG 網路。 若將此參數設為 $true,則必須手動設定 DAG 網路。
Type: | Boolean |
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 |
-MetaCacheDatabaseVolumesPerServer
將保留此參數供 Microsoft 內部使用。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2019 |
-NetworkCompression
NetworkCompression 參數會指定 DAG 網路壓縮選項。 有效值為:
- 已停用:所有網路上的網路壓縮已停用。
- 已啟用:已在所有網路上啟用網路壓縮。
- InterSubnetOnly:網路壓縮僅針對子網間通訊啟用。
- SeedOnly:網路壓縮僅針對植入啟用。
Type: | NetworkOption |
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 |
-NetworkEncryption
NetworkEncryption 參數會指定 DAG 網路加密選項。 有效值為:
- 已停用:所有網路上都會停用網路加密。
- 已啟用:已在所有網路上啟用網路加密。
- InterSubnetOnly:網路加密僅針對子網間通訊啟用。
- SeedOnly:僅針對植入啟用網路加密。
Type: | NetworkOption |
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 |
-PreferenceMoveFrequency
PreferenceMoveFrequency 參數會指定Microsoft Exchange 複寫服務檢查並自動重新平衡資料庫複本的頻率。 如果最慣用的資料庫副本 (ActivationPreference 值為 1) 不是作用中副本,則最慣用的資料庫副本會藉由執行無失真轉換來啟動。
若要指定值,請將其輸入為時間範圍:dd.hh:mm:ss,其中 dd = days、hh = hours、mm = minutes 和 ss = seconds。
預設值為 01:00:00 (1 小時)。 若要停用此功能,請指定 值 ([System.Threading.Timeout]::InfiniteTimeSpan)
。
重要:請勿指定大於 49.7 天的值。 較大的值會損毀MSExchangeRepl.exe所有 DAG 成員的 ArgumentOutOfRangeException 錯誤。
Type: | TimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-ReplayLagManagerEnabled
ReplayLagManagerEnabled 參數會為延遲的資料庫複本指定是否停用記錄檔案的自動 playdown。
Type: | Boolean |
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 |
-ReplicationPort
ReplicationPort 參數會指定用於複寫活動 (記錄傳送和植入) 的傳輸控制通訊協定 (TCP) 通訊埠。 如果未指定這個參數,預設的複寫通訊埠會是 TCP 64327。
Type: | UInt16 |
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 |
-SkipDagValidation
SkipDagValidation 參數會指定是否略過 DAG 的仲裁模型驗證,以及在設定 DAG 時針對 DAG 見證的健全檢查。 您不需要使用此參數指定值。
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 |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
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
WitnessDirectory 參數會指定用於儲存檔案共用見證資料的伺服器目錄名稱。 指定的目錄不得由其他任何 DAG 使用。
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
WitnessServer 參數會指定的伺服器名稱將作為 DAG 的見證。 指定的伺服器不得為 DAG 的成員。
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 |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。