New-AzSqlDatabaseFailoverGroup
此命令會建立新的 Azure SQL Database 故障轉移群組。
語法
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 Database 故障轉移群組。 在 FailoverGroupName.SqlDatabaseDnsSuffix(例如,FailoverGroupName.database.windows.net)和 FailoverGroupName.secondary.SqlDatabaseDnsSuffix 建立兩個 Azure SQL Database 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
輔助伺服器上的中斷是否應該觸發只讀端點的自動故障轉移。
類型: | AllowReadOnlyFailoverToPrimary |
接受的值: | Enabled, Disabled |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-FailoverGroupName
要建立的 Azure SQL Database 故障轉移群組名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-FailoverPolicy
Azure SQL Database 故障轉移群組的故障轉移原則。
類型: | FailoverPolicy |
接受的值: | Automatic, Manual |
Position: | Named |
預設值: | Manual |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-GracePeriodWithDataLossHours
如果主伺服器上發生中斷且無法完成故障轉移,且數據遺失,則起始自動故障轉移之前的間隔。
類型: | Int32 |
Position: | Named |
預設值: | 1 |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PartnerResourceGroupName
Azure SQL Database 故障轉移群組的次要資源群組名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PartnerServerList
故障轉移群組中的夥伴伺服器清單(0 部伺服器的空白清單)。
類型: | List<T>[String] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-PartnerServerName
Azure SQL Database 故障轉移群組的輔助伺服器名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-PartnerSubscriptionId
Azure SQL Database 故障轉移群組的次要訂用帳戶標識碼名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ReadOnlyEndpointTargetServer
唯讀端點的目標伺服器名稱。 如果為空白,則預設為 PartnerServerName 的值。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ResourceGroupName
資源群組的名稱。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-ServerName
故障轉移群組的主要 Azure SQL Database 伺服器名稱。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |