New-AzSqlDatabaseFailoverGroup

模組:

Az.Sql Module

此命令會建立新的 Azure SQL 資料庫容錯移轉群組。

語法

Default (預設值)

New-AzSqlDatabaseFailoverGroup
    [-ServerName] <String>
    -FailoverGroupName <String>
    [-PartnerSubscriptionId <String>]
    [-PartnerResourceGroupName <String>]
    -PartnerServerName <String>
    [-FailoverPolicy <FailoverPolicy>]
    [-GracePeriodWithDataLossHours <Int32>]
    [-AllowReadOnlyFailoverToPrimary <AllowReadOnlyFailoverToPrimary>]
    [-PartnerServerList <System.Collections.Generic.List`1[System.String]>]
    [-ReadOnlyEndpointTargetServer <String>]
    [-ResourceGroupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

為指定的伺服器建立新的 Azure SQL 資料庫容錯移轉群組。 兩個 Azure SQL 資料庫 TDS 端點會在 FailoverGroupName.SqlDatabaseDnsSuffix （例如 FailoverGroupName.database.windows.net） 和 FailoverGroupName.secondary.SqlDatabaseDnsSuffix 建立。 這些端點可用於分別連線到容錯移轉群組中的主要和次要伺服器。 如果主要伺服器受到中斷影響，則會根據容錯移轉群組的容錯移轉原則和寬限期的規定，觸發端點和資料庫的自動容錯移轉。 新建立的容錯移轉群組不包含任何資料庫。 若要控制容錯移轉群組中的資料庫集，請使用 'Add-AzSqlDatabaseToFailoverGroup' 和 'Remove-AzSqlDatabaseFromFailoverGroup' Cmdlet。 '-GracePeriodWithDataLossHours' 參數僅支援大於或等於 1 小時的值。

[!附註] 從 Az.SQL 3.11.0 開始，您可以使用 Azure Powershell 中的 -PartnerSubscriptionId 參數，跨訂用帳戶部署自動容錯移轉群組。

範例

範例 1

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg -ServerName primaryserver -PartnerServerName secondaryserver -FailoverGroupName fg -FailoverPolicy Automatic -GracePeriodWithDataLossHours 1

此指令會為相同資源群組中的兩部伺服器建立具有失效接手原則「自動」的新失效接手群組。

範例 2

$failoverGroup = New-AzSqlDatabaseFailoverGroup -ResourceGroupName rg1 -ServerName primaryserver -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverGroupName fg -FailoverPolicy Manual

此指令會為不同資源群組中的兩部伺服器建立具有失效接手原則「手動」的新容錯移轉群組。

範例 3

$sub2 = 'b3c40cd6-024f-428c-921b-cda6c6834c34'
$failoverGroup = New-AzSqlDatabaseFailoverGroup -ServerName primaryserver -FailoverGroupName fg -PartnerSubscriptionId $sub2 -PartnerResourceGroupName rg2 -PartnerServerName secondaryserver1 -FailoverPolicy Manual -ResourceGroupName rg1

FailoverGroupName                    : fg
Location                             : East US
ResourceGroupName                    : rg1
ServerName                           : primaryserver
PartnerLocation                      : West US 2
PartnerResourceGroupName             : rg2
PartnerServerName                    : secondaryserver1
ReplicationRole                      : Primary
ReplicationState                     : CATCH_UP
ReadWriteFailoverPolicy              : Manual
FailoverWithDataLossGracePeriodHours :
DatabaseNames                        : {}

此命令會為不同訂用帳戶中的兩部伺服器建立具有容錯移轉原則「手動」的新容錯移轉群組。

參數

-AllowReadOnlyFailoverToPrimary

次要伺服器上的中斷是否應該觸發唯讀端點的自動容錯移轉。

參數屬性

類型:	AllowReadOnlyFailoverToPrimary
預設值:	None
接受的值:	Enabled, Disabled
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-DefaultProfile

用來與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

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

-FailoverGroupName

要建立的 Azure SQL 資料庫容錯移轉群組名稱。

參數屬性

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

參數集

(All)

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

-FailoverPolicy

Azure SQL 資料庫容錯移轉群組的容錯移轉原則。

參數屬性

類型:	FailoverPolicy
預設值:	Manual
接受的值:	Automatic, Manual
支援萬用字元:	False
不要顯示:	False

參數集

(All)

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

-GracePeriodWithDataLossHours

如果主要伺服器上發生中斷，且無法在不遺失資料的情況下完成失效接手，則啟動自動失效接手之前的間隔。

參數屬性

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

參數集

(All)

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

-PartnerResourceGroupName

Azure SQL 資料庫容錯移轉群組的次要資源群組名稱。

參數屬性

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

參數集

(All)

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

-PartnerServerList

容錯移轉群組中的合作夥伴伺服器清單 （0 部伺服器的空白清單）。

參數屬性

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

參數集

(All)

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

-PartnerServerName

Azure SQL 資料庫容錯移轉群組的次要伺服器名稱。

參數屬性

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

參數集

(All)

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

-PartnerSubscriptionId

Azure SQL 資料庫容錯移轉群組的次要訂用帳戶識別碼名稱。

參數屬性

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

參數集

(All)

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

-ReadOnlyEndpointTargetServer

唯讀端點的目標伺服器名稱。 如果是空的，則預設為 PartnerServerName 的值。

參數屬性

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

參數集

(All)

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

-ResourceGroupName

資源群組的名稱。

參數屬性

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

參數集

(All)

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

-ServerName

容錯移轉群組的主要 Azure SQL 資料庫伺服器名稱。

參數屬性

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

參數集

(All)

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

CommonParameters

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

輸入

String

輸出

AzureSqlFailoverGroupModel

相關連結

• Set-AzSqlDatabaseFailoverGroup
• Get-AzSqlDatabaseFailoverGroup
• Add-AzSqlDatabaseToFailoverGroup
• Remove-AzSqlDatabaseFromFailoverGroup
• Switch-AzSqlDatabaseFailoverGroup
• Remove-AzSqlDatabaseFailoverGroup
• SQL 資料庫檔