Set-SqlAvailabilityReplica

構文

Set-SqlAvailabilityReplica
   [-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
   [-FailoverMode <AvailabilityReplicaFailoverMode>]
   [-EndpointUrl <String>]
   [-SessionTimeout <Int32>]
   [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
   [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
   [-SeedingMode <AvailabilityReplicaSeedingMode>]
   [-BackupPriority <Int32>]
   [-ReadOnlyRoutingList <String[]>]
   [-ReadonlyRoutingConnectionUrl <String>]
   [-LoadBalancedReadOnlyRoutingList <String[][]>]
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SqlAvailabilityReplica
   [-AvailabilityMode <AvailabilityReplicaAvailabilityMode>]
   [-FailoverMode <AvailabilityReplicaFailoverMode>]
   [-EndpointUrl <String>]
   [-SessionTimeout <Int32>]
   [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
   [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
   [-SeedingMode <AvailabilityReplicaSeedingMode>]
   [-BackupPriority <Int32>]
   [-ReadOnlyRoutingList <String[]>]
   [-ReadonlyRoutingConnectionUrl <String>]
   [-LoadBalancedReadOnlyRoutingList <String[][]>]
   [-InputObject] <AvailabilityReplica>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-SqlAvailabilityReplica コマンドレットは、可用性レプリカのさまざまなプロパティを設定または変更します。 プライマリ レプリカをホストするサーバー インスタンスでこのコマンドレットを実行します。

例

例 1: レプリカ可用性モードと自動フェールオーバーを変更する

PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode "SynchronousCommit" -FailoverMode Automatic -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"

このコマンドは、可用性モードを使用し、automatic failoverをサポートするために、MainAG という名前の可用性グループ synchronous-commitReplica02 という名前のレプリカを変更します。

例 2: 強制手動フェールオーバーをサポートするようにレプリカを変更する

PS C:\> Set-SqlAvailabilityReplica -AvailabilityMode AsynchronousCommit -FailoverMode Manual -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"

このコマンドは、MainAG という名前の可用性グループの Replica02 という名前のレプリカを、asynchronous-commit 可用性モードを使用し、forced manual failoverのみをサポートするように変更します。これにより、データ損失が発生する可能性があります。

例 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"
PS C:\> $PrimaryReplica = Get-Item "AvailabilityReplicas\PrimaryServer"
PS C:\> $SecondaryReplica = Get-Item "AvailabilityReplicas\SecondaryServer"
PS C:\> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://PrimaryServer.domain.com:5022" -InputObject $PrimaryReplica
PS C:\> Set-SqlAvailabilityReplica -ReadOnlyRoutingConnectionUrl "TCP://SecondaryServer.domain.com:5022" -InputObject $SecondaryReplica
PS C:\> Set-SqlAvailabilityReplica -ReadOnlyRoutingList "SecondaryServer","PrimaryServer" -InputObject $PrimaryReplica

最初のコマンドは、SQLSERVER: プロバイダー内の場所に場所を変更します。

4 番目のコマンドは、プライマリ レプリカに読み取り専用ルーティング URL を割り当てます。 次に、プライマリ レプリカの読み取り専用ルーティング リストを設定します。

例 5: バックアップの優先順位を変更する

PS C:\> Set-SqlAvailabilityReplica -BackupPriority 60 -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG\AvailabilityReplicas\Replica02"

このコマンドは、可用性レプリカ Replica02 のバックアップ優先度を 60に設定します。 この優先順位は、プライマリ レプリカをホストするサーバー インスタンスによって使用され、可用性グループ内のデータベースで自動バックアップ要求を処理するレプリカを決定します。 優先順位が最も高いレプリカが選択されます。

パラメーター

-AccessToken

-AvailabilityMode

-BackupPriority

-Confirm

-ConnectionModeInPrimaryRole

-ConnectionModeInSecondaryRole

-Encrypt

-EndpointUrl

-FailoverMode

-HostNameInCertificate

-InputObject

-LoadBalancedReadOnlyRoutingList

-Path

-ProgressAction

-ReadonlyRoutingConnectionUrl

-ReadOnlyRoutingList

-Script

-SeedingMode

-SessionTimeout

-TrustServerCertificate

-WhatIf

入力

Microsoft.SqlServer.Management.Smo.AvailabilityReplica

関連リンク

• New-SqlAvailabilityReplica
• Remove-SqlAvailabilityReplica
• Test-SqlAvailabilityReplica