New-AzureRmVMSqlServerAutoBackupConfig

SQL Server 自動バックアップの構成オブジェクトを作成します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

New-AzureRmVMSqlServerAutoBackupConfig
   [-ResourceGroupName] <String>
   [-Enable]
   [[-RetentionPeriodInDays] <Int32>]
   [-EnableEncryption]
   [[-CertificatePassword] <SecureString>]
   [[-StorageUri] <Uri>]
   [[-StorageKey] <SecureString>]
   [-BackupSystemDbs]
   [-BackupScheduleType <String>]
   [-FullBackupFrequency <String>]
   [-FullBackupStartHour <Int32>]
   [-FullBackupWindowInHours <Int32>]
   [-LogBackupFrequencyInMinutes <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmVMSqlServerAutoBackupConfig
   [-ResourceGroupName] <String>
   [-Enable]
   [[-RetentionPeriodInDays] <Int32>]
   [-EnableEncryption]
   [[-CertificatePassword] <SecureString>]
   [[-StorageContext] <IStorageContext>]
   [[-StorageUri] <Uri>]
   [[-StorageKey] <SecureString>]
   [-BackupSystemDbs]
   [-BackupScheduleType <String>]
   [-FullBackupFrequency <String>]
   [-FullBackupStartHour <Int32>]
   [-FullBackupWindowInHours <Int32>]
   [-LogBackupFrequencyInMinutes <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

New-AzureRmVMSqlServerAutoBackupConfig コマンドレットは、SQL Server 自動バックアップの構成オブジェクトを作成します。

例 1: ストレージ URI とアカウント キーを使用して自動バックアップ構成を作成する

PS C:\> $AutoBackupConfig = New-AzureRmVMSqlServerAutoBackupConfig -Enable -RetentionPeriod 10 -StorageUri "\\contoso\StorageGeneral" -StorageKey "< Storage Key for ContosoGeneral >"
Enable                : True
EnableEncryption      : False
RetentionPeriodInDays : 10

このコマンドでは、ストレージ URI とアカウント キーを指定して、自動バックアップ構成オブジェクトを作成します。 自動バックアップが有効になり、自動バックアップは 10 日間保持されます。 このコマンドは、結果を $AutoBackupConfig 変数に格納します。 Set-AzureRmVMSqlServerExtension コマンドレットなど、他のコマンドレットに対してこの構成項目を指定できます。

例 2: ストレージ コンテキストを使用して自動バックアップ構成を作成する

PS C:\> $StorageContext = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral >"
PS C:\> $AutoBackupConfig = New-AzureRmVMSqlServerAutoBackupConfig -StorageContext $StorageContext -Enable -RetentionPeriod 10
Enable                : True
EnableEncryption      : False
RetentionPeriodInDays : 10

最初のコマンドは、ストレージ コンテキストを作成し、$StorageContext変数に格納します。 詳細については、「 New-AzureStorageContext」を参照してください。 2 番目のコマンドでは、$StorageContextでストレージ コンテキストを指定して、自動バックアップ構成オブジェクトを作成します。 自動バックアップが有効になり、自動バックアップは 10 日間保持されます。

例 3: 暗号化とパスワードを使用してストレージ コンテキストを使用して自動バックアップ構成を作成する

PS C:\> $StorageContext = New-AzureRmVMSqlServerAutoBackupConfig -StorageContext $StorageContext -Enable -RetentionPeriod 10 -EnableEncryption -CertificatePassword $CertificatePassword
Enable                : True
EnableEncryption      : True
RetentionPeriodInDays : 10

このコマンドは、自動バックアップ構成オブジェクトを作成して格納します。 このコマンドは、前の例で作成したストレージ コンテキストを指定します。 このコマンドを使用すると、パスワードを使用した暗号化が有効になります。 パスワードは、以前はセキュリティで保護された文字列として$CertificatePassword変数に格納されていました。 セキュリティで保護された文字列を作成するには、ConvertTo-SecureString コマンドレットを使用します。

パラメーター

-BackupScheduleType

バックアップ スケジュールの種類(手動または自動)

型:String
指定可能な値:Manual, Automated
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-BackupSystemDbs

システム データベースのバックアップ

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-CertificatePassword

SQL Server で暗号化されたバックアップを実行するために使用される証明書を暗号化するためのパスワードを指定します。

型:SecureString
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Enable

SQL Server 仮想マシンの自動バックアップが有効になっていることを示します。 このパラメーターを指定すると、自動バックアップによって、すべての現在および新しいデータベースのバックアップ スケジュールが設定されます。 これにより、このスケジュールに従ってマネージド バックアップの設定が更新されます。

型:SwitchParameter
配置:1
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-EnableEncryption

このコマンドレットで暗号化が有効であることを示します。

型:SwitchParameter
配置:3
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-FullBackupFrequency

Sql Server の完全バックアップの頻度 (毎日または毎週)

型:String
指定可能な値:Daily, Weekly
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-FullBackupStartHour

Sql Server の完全バックアップを開始する時刻 (0 から 23)

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-FullBackupWindowInHours

Sql Server の [完全バックアップ] ウィンドウ (時間単位)

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-LogBackupFrequencyInMinutes

Sql Server ログ バックアップの頻度 (1 ~ 60 分に 1 回)

型:Nullable<T>[Int32]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

仮想マシンのリソース グループの名前を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RetentionPeriodInDays

バックアップを保持する日数を指定します。

型:Int32
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageContext

バックアップの格納に使用するストレージ アカウントを指定します。 AzureStorageContext オブジェクトを取得するには、New-AzureStorageContext コマンドレットを使用します。 既定値は、SQL Server 仮想マシンに関連付けられているストレージ アカウントです。

型:IStorageContext
配置:5
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageKey

BLOB ストレージ アカウントのストレージ キーを指定します。

型:SecureString
配置:5
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageUri

BLOB ストレージ アカウントの URI (Uniform Resource Identifier) を指定します。

型:Uri
配置:4
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

String

SwitchParameter

Int32

IStorageContext

Uri

SecureString

Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

出力

AutoBackupSettings