New-SqlAvailabilityReplica

模組:: SQLPS Module

建立可用性複本。

語法

ByPath (預設值)

New-SqlAvailabilityReplica
    [-Name] <String>
    [[-Path] <String>]
    -AvailabilityMode <AvailabilityReplicaAvailabilityMode>
    -FailoverMode <AvailabilityReplicaFailoverMode>
    -EndpointUrl <String>
    [-SessionTimeout <Int32>]
    [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
    [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
    [-BackupPriority <Int32>]
    [-ReadOnlyRoutingList <String[]>]
    [-ReadonlyRoutingConnectionUrl <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AsTemplate

New-SqlAvailabilityReplica
    [-Name] <String>
    -AvailabilityMode <AvailabilityReplicaAvailabilityMode>
    -FailoverMode <AvailabilityReplicaFailoverMode>
    -EndpointUrl <String>
    [-SessionTimeout <Int32>]
    [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
    [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
    [-BackupPriority <Int32>]
    [-ReadOnlyRoutingList <String[]>]
    [-ReadonlyRoutingConnectionUrl <String>]
    [-AsTemplate]
    [-Version <ServerVersion>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

New-SqlAvailabilityReplica
    [-Name] <String>
    [-InputObject] <AvailabilityGroup>
    -AvailabilityMode <AvailabilityReplicaAvailabilityMode>
    -FailoverMode <AvailabilityReplicaFailoverMode>
    -EndpointUrl <String>
    [-SessionTimeout <Int32>]
    [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
    [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
    [-BackupPriority <Int32>]
    [-ReadOnlyRoutingList <String[]>]
    [-ReadonlyRoutingConnectionUrl <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-SqlAvailabilityReplica Cmdlet 會建立可用性複本。在裝載主要複本的 SQL Server 實例上執行此 Cmdlet。

若要在建立可用性群組之前建立可用性複本，請指定 AsTemplate 參數。若要將復本新增至現有的可用性群組， InputObject 或 Path 參數會指定可用性群組。

範例

範例 1：建立可用性複本的表示法

PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "PrimaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate -Version $ServerObject.Version

此範例會建立可用性複本的記憶體內部表示法。伺服器不會認可任何變更。您可以使用此複本作為 New-SqlAvailabilityGroup之 AvailabilityReplica 參數的值

第一個命令會取得主伺服器的實例。

第二個命令會建立可用性複本。此複本會使用位於指定 URL 的資料庫鏡像端點，與可用性群組中的其他復本通訊。此復本支持自動故障轉移和同步認可可用性模式。 Version 參數會指定將裝載這個新複本的伺服器實例版本。

範例 2：建立支援手動故障轉移和異步認可的可用性複本

PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -AsTemplate -Version $ServerObject.Version

此範例會建立可用性複本的記憶體內部表示法。伺服器不會認可任何變更。

第一個命令會取得主伺服器的實例。

第二個命令會建立可用性複本。此複本會使用位於指定 URL 的資料庫鏡像端點，與可用性群組中的其他復本通訊。此復本支援手動故障轉移和異步認可可用性模式。 Version 參數會指定將裝載這個新複本的伺服器實例版本。

範例 3：將可用性復本新增至可用性群組

PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"

此命令會將可用性復本新增至名為 MainAG 的現有可用性群組。此複本支援手動容錯移轉和非同步認可的可用性模式。在次要角色中，此複本支援讀取存取連線。此組態可讓您卸除此複本的唯讀處理。

參數

-AsTemplate

指出此 Cmdlet 會在記憶體中建立暫存 AvailabilityReplica 物件。在建立可用性複本之前，請指定此參數來建立可用性群組。使用 New-SqlAvailabilityGroup Cmdlet 建立可用性群組。將暫存可用性複本指定為 AvailabilityReplica 參數的值。

如果您指定 AsTemplate，此 Cmdlet 會忽略 InputObject 和 Path 參數的值。

如果您指定此參數，您也必須為 Version 參數指定 SQL Server 版本，否則目前的會話必須具有實例的作用中連線。

參數屬性

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

參數集

AsTemplate

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

-AvailabilityMode

指定複本可用性模式。此參數可接受的值為：

SynchronousCommit
AsynchronousCommit

您可以指定 $Null 的值。

參數屬性

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

參數集

(All)

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

-BackupPriority

指定執行備份中複本所需的優先權。此參數可接受的值為：從 0 到 100 的整數。在在線和可用的複本集合中，具有最高優先順序的複本會執行備份。

參數屬性

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

參數集

(All)

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

-Confirm

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

參數屬性

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

參數集

(All)

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

-ConnectionModeInPrimaryRole

指定可用性複本在主要角色中處理連線的方式。此參數可接受的值為：

AllowReadWriteConnections。允許讀取/寫入連線
AllowAllConnections。允許所有連線

參數屬性

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

參數集

(All)

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

-ConnectionModeInSecondaryRole

指定可用性複本在次要角色中處理連線的方式。此參數可接受的值為：

AllowNoConnections。不允許連線
AllowReadIntentConnectionsOnly。只允許讀取意圖連線
AllowAllConnections。允許所有連線

參數屬性

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

參數集

(All)

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

-EndpointUrl

指定資料庫鏡像端點的 URL。此網址是下列格式的 TCP 位址：

TCP：//system-address：port

參數屬性

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

參數集

(All)

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

-FailoverMode

指定故障轉移模式。此參數可接受的值為：

自動
手動您可以指定$Null的值。

參數屬性

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

參數集

(All)

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

-InputObject

將可用性群組指定為複本所屬 的 AvailabilityGroup 物件。

參數屬性

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

參數集

ByObject

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

-Name

以下欄格式指定可用性複本的名稱：

計算機\實例

參數屬性

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

參數集

(All)

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

-Path

指定複本所屬可用性群組的路徑。如果您未指定此參數，此 Cmdlet 會使用目前的工作位置。

參數屬性

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

參數集

ByPath

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

-ReadonlyRoutingConnectionUrl

指定路由至複本以進行唯讀連線時要使用的完整功能變數名稱（FQDN）和埠，如下列範例所示：

TCP://DBSERVER8.manufacturing.Contoso.com:7024

參數屬性

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

參數集

(All)

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

-ReadOnlyRoutingList

指定複本伺服器名稱的排序列表，此列表代表透過此可用性複本重新導向只讀連線時要使用的連接控制器探查順序。如果可用性複本是可用性群組的目前主要複本，則適用此參數。

參數屬性

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

參數集

(All)

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

-Script

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

參數屬性

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

參數集

(All)

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

-SessionTimeout

指定在連線失敗之前，等候主要複本與此複本之間回應的時間量，以秒為單位。

參數屬性

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

參數集

(All)

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

-Version

指定 SQL Server 版本。如果您指定 AsTemplate 參數，則必須指定版本。範本物件會在包含此版本的伺服器上，以設計模式建立。您可以指定整數或字串，如下列範例所示：

13
"13.0.0"

參數屬性

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

參數集

AsTemplate

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。

共用方式為

New-SqlAvailabilityReplica

語法

ByPath (預設值)

AsTemplate

ByObject

Description

範例

範例 1：建立可用性複本的表示法

範例 2：建立支援手動故障轉移和異步認可的可用性複本

範例 3：將可用性復本新增至可用性群組

參數

-AsTemplate

參數屬性

參數集

-AvailabilityMode

參數屬性

參數集

-BackupPriority

參數屬性

參數集

-Confirm

參數屬性

參數集

-ConnectionModeInPrimaryRole

參數屬性

參數集

-ConnectionModeInSecondaryRole

參數屬性

參數集

-EndpointUrl

參數屬性

參數集

-FailoverMode

參數屬性

參數集

-InputObject

參數屬性

參數集

-Name

參數屬性

參數集

-Path

參數屬性

參數集

-ReadonlyRoutingConnectionUrl

參數屬性

參數集

-ReadOnlyRoutingList

參數屬性

參數集

-Script

參數屬性

參數集

-SessionTimeout

參數屬性

參數集

-Version

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

輸出

Microsoft.SqlServer.Management.Smo.AvailabilityReplica

相關連結

意見反應