New-SqlAvailabilityReplica
建立可用性複本。
語法
New-SqlAvailabilityReplica
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-SqlAvailabilityReplica
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-AsTemplate]
[-Version <ServerVersion>]
[-Name] <String>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-SqlAvailabilityReplica
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-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 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AvailabilityMode
指定複本可用性模式。 此參數可接受的值為：
- SynchronousCommit
- AsynchronousCommit
您可以指定值 $Null。
| 類型: | AvailabilityReplicaAvailabilityMode |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-BackupPriority
指定執行備份中複本所需的優先順序。 此參數可接受的值為：從 0 到 100 的整數。 在在線和可用的複本集合中，具有最高優先順序的複本會執行備份。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
在執行 Cmdlet 前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ConnectionModeInPrimaryRole
指定可用性複本在主要角色中處理連線的方式。 此參數可接受的值為：
- AllowReadWriteConnections。 允取讀取/寫入連接
- AllowAllConnections。 允許所有連接
| 類型: | AvailabilityReplicaConnectionModeInPrimaryRole |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ConnectionModeInSecondaryRole
指定可用性複本在次要角色中處理連線的方式。 此參數可接受的值為：
- AllowNoConnections。 不允許連線
- AllowReadIntentConnectionsOnly。 只允許唯讀意圖連線
- AllowAllConnections。 允許所有連線
| 類型: | AvailabilityReplicaConnectionModeInSecondaryRole |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EndpointUrl
指定資料庫鏡像端點的 URL。 此網址是下列格式的 TCP 位址：
TCP://system-address:連接埠
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-FailoverMode
指定故障轉移模式。 此參數可接受的值為：
- 自動
- 手動 您可以指定值$Null。
| 類型: | AvailabilityReplicaFailoverMode |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
將可用性群組指定為複本所屬 的 AvailabilityGroup 物件。
| 類型: | AvailabilityGroup |
| Position: | 3 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
以下欄格式指定可用性複本的名稱：
計算機\實例
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Path
指定複本所屬可用性群組的路徑。 如果您未指定此參數，此 Cmdlet 會使用目前的工作位置。
| 類型: | String |
| Position: | 3 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ReadonlyRoutingConnectionUrl
指定路由至複本以進行只讀連線時，FQDN (完整域名) 和埠，如下列範例所示：
TCP://DBSERVER8.manufacturing.Contoso.com:7024
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ReadOnlyRoutingList
指定複本伺服器名稱的已排序列表，代表透過這個可用性複本重新導向唯讀連線時要使用的連接 Director 探查順序。 如果可用性複本是可用性群組目前的主要複本，則此參數適用。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Script
表示此 Cmdlet 會傳回 Transact-SQL 腳本，以執行此 Cmdlet 執行的工作。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SessionTimeout
指定在連線失敗之前，等候主要複本與此複本之間回應的時間量，以秒為單位。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Version
指定 SQL Server 版本。 如果您指定 AsTemplate 參數，則必須指定版本。 範本物件是在包含此版本的伺服器上，以設計模式建立。 您可以指定整數或字串，如下列範例所示：
- 13
- "13.0.0"
| 類型: | ServerVersion |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.SqlServer.Management.Smo.AvailabilityGroup
您可以將可用性群組傳遞至此 Cmdlet。
輸出
Microsoft.SqlServer.Management.Smo.AvailabilityReplica
此 Cmdlet 會傳回可用性複本。