Set-SqlAvailabilityReplica
設定可用性復本上的設定。
語法
ByPath (預設值)
Set-SqlAvailabilityReplica
[[-Path] <String>]
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Set-SqlAvailabilityReplica
[-InputObject] <AvailabilityReplica>
[-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
[-FailoverMode <AvailabilityReplicaFailoverMode>]
[-EndpointUrl <String>]
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-SqlAvailabilityReplica Cmdlet 會設定或修改可用性複本的各種屬性。 在裝載主要複本的伺服器實例上執行此 Cmdlet。
範例
範例 1：修改複本可用性模式和自動故障轉移
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
此命令會修改 MainAG 可用性群組中名為 Replica02 的複本，以使用同步認可可用性模式並支援自動故障轉移。
範例 2：修改複本以支持強制手動故障轉移
PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
此命令會修改名為 MainAG 的可用性群組中名為 Replica02 的複本，以使用異步認可可用性模式，並僅支持強制手動故障轉移，這可能會導致數據遺失。
範例 3：允許次要角色中的所有連線
PS C:\> Set-SqlAvailabilityReplica -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
此命令會修改可用性群組 MainAG 中的複本 'Replica02'，以允許次要角色中的所有連線。 這可讓您將唯讀數據處理工作負載卸除至次要複本。
範例 4：設定主要複本和次要複本以進行唯讀路由
PS C:\> Set-Location "SQLSERVER:\SQL\PrimaryServer\default\AvailabilityGroups\MainAG"
C:\PS> $PrimaryReplica = Get-Item "AvailabilityReplicas\PrimaryServer"
C:\PS> $SecondaryReplica = Get-Item "AvailabilityReplicas\SecondaryServer"
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://PrimaryServer.domain.com:5022" -InputObject $PrimaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://SecondaryServer.domain.com:5022" -InputObject $SecondaryReplica
C:\PS> Set-SqlAvailabilityReplica -ReadOnlyRoutingList "SecondaryServer","PrimaryServer" -InputObject $PrimaryReplica
第一個命令會將位置變更為 SQLSERVER： 提供者中的位置。
第二個命令會取得主伺服器的複本，然後將它儲存在 $PrimaryReplica 變數中。
第三個命令會取得輔助伺服器的複本，然後將它儲存在$SecondaryReplica變數中。
第四個命令會將唯讀路由URL指派給主要複本。 然後，它會在主要複本上設定唯讀路由清單。
第五個命令會將唯讀路由URL指派給次要複本。
第六個命令會設定主要複本上的唯讀路由清單。 具有 ReadOnly 屬性連接字串的連接會重新導向至次要複本。 如果次要複本無法讀取，聯機會導向回主要複本。
範例 5：修改備份優先順序
PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"
此命令會將可用性復本 『Replica02』的備份優先順序設定為 60。 裝載主要複本的伺服器實例會使用此優先順序，以決定哪些複本應該在可用性群組中的資料庫上服務自動備份要求。 已選擇優先順序最高的複本。
參數
-AvailabilityMode
指定複本可用性模式。 此參數可接受的值為：
- SynchronousCommit
- AsynchronousCommit
您可以指定 $Null 的值。
參數屬性
| 類型: | AvailabilityReplicaAvailabilityMode |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-BackupPriority
指定執行備份中複本所需的優先權。 此參數可接受的值為：從 0 到 100 的整數。 在在線和可用的複本集合中，具有最高優先順序的複本會執行備份。
值為零 （0） 表示複本不是候選複本。
參數屬性
| 類型: | 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 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FailoverMode
指定故障轉移模式。 此參數可接受的值為：
- 自動
- 手動。 您可以指定 $Null 的值。
參數屬性
| 類型: | AvailabilityReplicaFailoverMode |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
將可用性群組指定為複本所屬 的 AvailabilityGroup 物件。
參數屬性
| 類型: | AvailabilityReplica |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByObject
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定複本所屬可用性群組的路徑。 如果您未指定此參數，此 Cmdlet 會使用目前的工作位置。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ByPath
| Position: | 2 |
| 必要: | 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 |
-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。