New-AzSqlDatabaseFailoverGroup

  • 參考
模組:
Az.Sql

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

Syntax

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 資料庫 故障轉移群組。 在 FailoverGroupName.SqlDatabaseDnsSuffix（例如，FailoverGroupName.database.windows.net）和 FailoverGroupName.secondary.SqlDatabaseDnsSuffix 上建立兩個 Azure SQL 資料庫 TDS 端點。 這些端點可用來分別連線到故障轉移群組中的主要和輔助伺服器。 如果主伺服器受到中斷的影響，則會依照故障轉移群組的故障轉移原則和寬限期來觸發端點和資料庫的自動故障轉移。 新建立的故障轉移群組不包含任何資料庫。 若要控制故障轉移群組中的資料庫集合，請使用 '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

此命令會為不同資源群組中的兩部伺服器建立具有故障轉移原則 『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                        : {}

此命令會為不同訂用帳戶中的兩部伺服器建立具有故障轉移原則 『Manual』 的新故障轉移群組。

參數

-AllowReadOnlyFailoverToPrimary

輔助伺服器上的中斷是否應該觸發只讀端點的自動故障轉移。

Type:AllowReadOnlyFailoverToPrimary
Accepted values:Enabled, Disabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailoverGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FailoverPolicy

Azure SQL 資料庫 故障轉移群組的故障轉移原則。

Type:FailoverPolicy
Accepted values:Automatic, Manual
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GracePeriodWithDataLossHours

如果主伺服器上發生中斷且無法完成故障轉移，且數據遺失，則起始自動故障轉移之前的間隔。

Type:Int32
Position:Named
Default value:1
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerResourceGroupName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServerList

故障轉移群組中的夥伴伺服器清單（0 部伺服器的空白清單）。

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServerName

Azure SQL 資料庫 故障轉移群組的輔助伺服器名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartnerSubscriptionId

Azure SQL 資料庫 故障轉移群組的次要訂用帳戶標識碼名稱。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReadOnlyEndpointTargetServer

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

資源群組的名稱。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

輸入

String

輸出

AzureSqlFailoverGroupModel