Suspend-SqlAvailabilityDatabase

モジュール:

SQLServer

可用性データベースのデータ移動を中断します。

構文

Suspend-SqlAvailabilityDatabase
       [[-Path] <String[]>]
       [-Script]
       [-AccessToken <PSObject>]
       [-TrustServerCertificate]
       [-HostNameInCertificate <String>]
       [-Encrypt <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Suspend-SqlAvailabilityDatabase
       [-InputObject] <AvailabilityDatabase[]>
       [-Script]
       [-AccessToken <PSObject>]
       [-TrustServerCertificate]
       [-HostNameInCertificate <String>]
       [-Encrypt <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Suspend-SqlAvailabilityDatabase コマンドレットは、可用性データベースでのデータ移動を中断します。 このコマンドレットは、現在のサーバー インスタンスによってホストされているレプリカ上のデータベースを中断します。 セカンダリ データベースを中断すると、このコマンドレットは状態を に SUSPENDED設定します。 対応するプライマリ データベースの背後に配置されます。 プライマリ データベースを中断すると、すべてのセカンダリ レプリカでデータ移動が停止します。

例

例 1: データベースの同期を中断する

PS C:\> Suspend-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\Server\Instance\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16"

このコマンドは、 という名前Server\Instanceのサーバー インスタンスの MainAG という名前の可用性グループ内の可用性データベースDatabase16のデータ同期を中断します。

例 2: すべてのデータベースの同期を中断する

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\Instance\AvailabilityGroups\MainAG\AvailabilityDatabases" | Suspend-SqlAvailabilityDatabase

このコマンドは、 に属するすべての可用性データベースを MainAG取得し、パイプライン演算子を使用して現在のコマンドレットに渡します。 現在のコマンドレットは、各可用性データベースを中断します。

例 3: データベースを中断するスクリプトを作成する

PS C:\> Suspend-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\Server\Instance\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16" -Script

このコマンドは、 というMainAG名前の可用性グループ内の という可用性Database16データベースを中断する Transact-SQL スクリプトを作成します。 コマンドは、このアクションを実行しません。

パラメーター

-AccessToken

ユーザー/パスワードまたは Windows 認証の代わりに、SQL Serverに対する認証に使用されるアクセス トークン。

これは、たとえば、 または を使用して にSQL Azure DB接続したりSQL Azure Managed Instance、 を使用したりManaged Identityするために使用Service Principalできます。

使用するパラメーターには、 を実行Get-AzAccessToken -ResourceUrl https://database.windows.netして返されるトークンまたはオブジェクトをPSAccessToken表す文字列を指定できます。

このパラメーターは、モジュールの v22 の新機能です。

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Encrypt

SQL Serverに接続するときに使用する暗号化の種類。

この値は、 Encrypt Microsoft.Data.SqlClient ドライバーの SqlConnection オブジェクトの プロパティ SqlConnectionEncryptOption にマップされます。

モジュールの v22 では、既定値は Optional (v21 との互換性のために) です。 モジュールの v23 以降では、既定値は "必須" になります。これにより、既存のスクリプトに破壊的変更が発生する可能性があります。

このパラメーターは、モジュールの v22 の新機能です。

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

SQL Server TLS/SSL 証明書の検証に使われるホスト名。 SQL Server インスタンスで Force Encryption が有効になっており、hostname/shortname を使用してインスタンスに接続する場合は、このパラメーターを渡す必要があります。 このパラメーターを省略した場合、強制暗号化が有効になっているSQL Server インスタンスに接続するには、完全修飾ドメイン名 (FQDN) を -ServerInstance に渡す必要があります。

このパラメーターは、モジュールの v22 の新機能です。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

このコマンドレットが中断する可用性データベースを AvailabilityDatabase オブジェクトとして指定します。

Type:	AvailabilityDatabase[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

コマンドレットが中断する可用性データベースのパスを指定します。 このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

このコマンドレットによって、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトが返されることを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

信頼を検証するために証明書チェーンの歩き方をバイパスしながらチャネルを暗号化するかどうかを示します。

モジュールの v22 では、既定値は $true (v21 との互換性のために) です。 モジュールの v23 以降では、既定値は "$false" になります。これにより、既存のスクリプトに破壊的変更が発生する可能性があります。

このパラメーターは、モジュールの v22 の新機能です。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.SqlServer.Management.Smo.AvailabilityDatabase[]

可用性データベースをこのコマンドレットに渡すことができます。

メモ

このコマンドを実行するインスタンスは、高可用性のために有効にする必要があります。

関連リンク

• Add-SqlAvailabilityDatabase
• Remove-SqlAvailabilityDatabase
• Resume-SqlAvailabilityDatabase