New-SqlAvailabilityGroup

模組:

SQLPS Module

建立可用性群組。

語法

ByPath (預設值)

New-SqlAvailabilityGroup
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

New-SqlAvailabilityGroup
    [-Name] <String>
    [-InputObject] <Server>
    -AvailabilityReplica <AvailabilityReplica[]>
    [-Database <String[]>]
    [-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
    [-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
    [-HealthCheckTimeout <Int32>]
    [-BasicAvailabilityGroup]
    [-DatabaseHealthTrigger]
    [-DtcSupportEnabled]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-SqlAvailabilityGroup Cmdlet 會在 AlwaysOn 可用性群組中建立可用性群組。 InputObject 或 Path 參數會指定裝載初始主要複本的伺服器。

範例

範例 1：建立可用性群組

PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")

第一個命令會在主伺服器上取得 SQL Server 的實例，然後將它儲存在$PrimaryServer變數中。

第二個命令會在輔助伺服器上取得 SQL Server 的實例，然後將它儲存在$SecondaryServer變數中。

第三個命令會使用 New-SqlAvailabilityReplica Cmdlet 建立包含主伺服器實例的複本，然後將它儲存在$PrimaryReplica變數中。 命令會使用 $PrimaryServer 的 Version 屬性來指定伺服器實例的版本。

第四個命令會使用 New-SqlAvailabilityReplica 建立包含輔助伺服器實例的複本，然後將它儲存在$SecondaryReplica變數中。 命令會使用 $SecondaryServer 的 Version 屬性來指定伺服器實例的版本。

最後一個命令會建立可用性群組。 它會指定名稱、主伺服器、復本和其他資訊。

參數

-AutomatedBackupPreference

指定可用性群組的自動備份喜好設定。 此參數可接受的值為：

• 主要。 指定備份一律發生在主要復本上。 此選項支援在次要複本上執行備份時無法使用的功能，例如差異備份。
• SecondaryOnly。 指定一律不會在主要複本上執行備份。 如果主要複本是在線唯一的複本，則不會進行備份。
• 二 次。 指定備份發生在次要複本上，除非主要複本是在線唯一的複本。 然後，備份會在主要複本上發生。
• 沒有。 指定決定哪個復本執行備份時，不會考慮主要或次要狀態。 相反地，備份優先順序和在線狀態會決定哪個複本會執行備份。

參數屬性

類型:	AvailabilityGroupAutomatedBackupPreference
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AvailabilityReplica

指定這個 Cmdlet 包含在可用性群組中的可用性複本陣列。 若要取得 AvailabilityReplica 物件，請使用 New-SqlAvailabilityReplica Cmdlet。 指定 AsTemplate 參數。

參數屬性

類型:	AvailabilityReplica[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BasicAvailabilityGroup

New-SqlAvailabilityGroup Cmdlet 會在 AlwaysOn 可用性群組中建立可用性群組。 InputObject 或 Path 參數會指定裝載初始主要複本的伺服器。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Database

指定本機讀取/寫入使用者資料庫的陣列。 這些資料庫必須使用完整恢復模式，且不得使用 AUTO_CLOSE。 這些資料庫不能屬於另一個可用性群組，而且無法針對資料庫鏡像進行設定。 您必須指定此參數的值。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseHealthTrigger

New-SqlAvailabilityGroup Cmdlet 會在 AlwaysOn 可用性群組中建立可用性群組。 InputObject 或 Path 參數會指定裝載初始主要複本的伺服器。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DtcSupportEnabled

New-SqlAvailabilityGroup Cmdlet 會在 AlwaysOn 可用性群組中建立可用性群組。 InputObject 或 Path 參數會指定裝載初始主要複本的伺服器。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FailureConditionLevel

指定可用性群組的自動故障轉移行為。 此參數可接受的值為：

• OnServerDown。 如果 SQL Server 服務停止，故障轉移或重新啟動。
• OnServerUnresponsive。 如果滿足任何較低值的條件，則故障轉移或重新啟動，以及當 SQL Server 服務聯機到叢集且超過 HealthCheckTimeout 臨界值時，或如果目前處於主要角色的可用性複本處於失敗狀態，則為故障轉移或重新啟動。
• OnCriticalServerError。 如果滿足任何較低值的條件，以及發生內部嚴重伺服器錯誤時，故障轉移或重新啟動，包括記憶體不足狀況、嚴重的寫入存取違規或太多傾印。
• OnModerateServerError。 如果滿足任何較低值的條件，則故障轉移或重新啟動，如果發生中度伺服器錯誤，包括持續性記憶體不足狀況。
• OnAnyQualifiedFailureConditions。 如果滿足任何較低值的條件，則故障轉移或重新啟動，如果發生合格的失敗狀況，包括引擎背景工作線程耗盡和偵測到無法解決的死結。

參數屬性

類型:	AvailabilityGroupFailureConditionLevel
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-HealthCheckTimeout

指定時間長度，以毫秒為單位，之後 AlwaysOn 可用性群組會將無回應的伺服器宣告為狀況不良。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

指定裝載此 Cmdlet 所建立之可用性群組主要復本的 SQL Server 實例。

參數屬性

類型:	Server
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByObject

Position:	3
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

指定這個 Cmdlet 所建立的可用性群組名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定裝載此 Cmdlet 所建立之可用性群組之初始主要複本之 SQL Server 實例的路徑。 如果您未指定此參數，此 Cmdlet 會使用目前的工作位置。 如果您指定值，則路徑目前必須存在。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByPath

Position:	3
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Script

指出此 Cmdlet 會傳回執行此 Cmdlet 所執行工作的 Transact-SQL 腳本。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Microsoft.SqlServer.Management.Smo.Server

您可以將伺服器實例傳遞至此 Cmdlet。

輸出

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

此 Cmdlet 會傳回可用性群組。

相關連結

• Join-SqlAvailabilityGroup
• New-SqlAvailabilityReplica
• Remove-SqlAvailabilityGroup
• Set-SqlAvailabilityGroup
• Switch-SqlAvailabilityGroup
• Test-SqlAvailabilityGroup