New-AzureRmBackupProtectionPolicy
バックアップ ポリシーを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureRmBackupProtectionPolicy
[-Name] <String>
[-Type] <String>
[-BackupTime] <DateTime>
[[-DaysOfWeek] <String[]>]
[-RetentionPolicy] <AzureRMBackupRetentionPolicy[]>
[-Vault] <AzureRMBackupVault>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmBackupProtectionPolicy
[-Name] <String>
[-Type] <String>
[-Daily]
[-BackupTime] <DateTime>
[-RetentionPolicy] <AzureRMBackupRetentionPolicy[]>
[-Vault] <AzureRMBackupVault>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmBackupProtectionPolicy
[-Name] <String>
[-Type] <String>
[-Weekly]
[-BackupTime] <DateTime>
[-DaysOfWeek] <String[]>
[-RetentionPolicy] <AzureRMBackupRetentionPolicy[]>
[-Vault] <AzureRMBackupVault>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
New-AzureRmBackupProtectionPolicy コマンドレットは、Azure Backup ポリシーを Azure PowerShell オブジェクトとして作成します。 バックアップ ポリシーは、バックアップによって項目をバックアップするタイミングと頻度を定義します。 Enable-AzureRmBackupProtection コマンドレットは、バックアップ ポリシーを使用します。
例
例 1: 毎日および毎月のリテンション期間を使用して毎日のバックアップ ポリシーを作成する
PS C:\>$Vault = Get-AzureRmBackupVault -Name "Vault03"
PS C:\> $Daily = New-AzureRmBackupRetentionPolicyObject -DailyRetention -Retention 30
PS C:\> $Monthly = New-AzureRmBackupRetentionPolicyObject -MonthlyRetentionInDailyFormat -DaysOfMonth (10, 20) -Retention 12
PS C:\> $ProtectionPolicy = New-AzureRmBackupProtectionPolicy -Name DailyBackup01 -Type AzureVM -Daily -BackupTime ([datetime]"3:30 PM") -RetentionPolicy ($Daily,$Monthly) -Vault $Vault
Name Type ScheduleType BackupTime
---- ---- ------------ ----------
DailyBkp AzureVM Daily 26-Aug-15 3:00:00 PM
最初のコマンドでは、Get-AzureRmBackupVault コマンドレットを使用して、Vault03 という名前のコンテナーを取得します。 このコマンドは、そのオブジェクトを $Vault 変数に格納します。 2 番目のコマンドは、30 日間の毎日のリテンション期間の保持ポリシーを作成し、$Daily変数に格納します。 3 番目のコマンドは、12 か月間、毎月の 10 番目と 20 分の 1 にバックアップを保持する保持ポリシーを作成します。 このコマンドは、アイテム保持ポリシーを $Monthly 変数に格納します。 最後のコマンドは、毎日のバックアップ時間が午後 3 時である$Vaultにコンテナーのバックアップ ポリシーを作成します。 このコマンドは、$Dailyおよび$Monthlyに格納されているアイテム保持ポリシーを割り当てます。 このコマンドは、結果を $ProtectionPolicy 変数に格納します。
パラメーター
-BackupTime
バックアップ操作の日時を DateTime オブジェクトとして指定します。
DateTime を取得するには、Get-Date コマンドレットを使用します。
DateTime オブジェクトの詳細については、「.」と入力しますGet-Help Get-Date
。
型: | DateTime |
Position: | 5 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Daily
バックアップ操作が毎日のスケジュールで実行されることを示します。
型: | SwitchParameter |
Position: | 3 |
既定値: | None |
必須: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysOfWeek
曜日の配列を指定します。 このポリシーは、このパラメーターで指定された日にバックアップを実行します。 このパラメーターの有効値は、次のとおりです。
- 月曜日
- 火曜日
- 水曜日
- Thursday
- 金曜日
- 土曜日
- 日曜日 週単位のパラメーターを指定する場合は、このパラメーターを指定します。
型: | String[] |
承認された値: | Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday |
Position: | 6 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
既定値: | None |
必須: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
バックアップ ポリシーの名前を指定します。 コンテナー内で一意の名前を選択します。
型: | String |
Position: | 1 |
既定値: | None |
必須: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetentionPolicy
バックアップ ポリシーの保持ポリシーの配列を指定します。 AzureRmBackupRetentionPolicy を取得するには、New-AzureRmBackupRetentionPolicyObject コマンドレットを使用します。
型: | AzureRMBackupRetentionPolicy[] |
Position: | 7 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Type
ポリシーを適用するバックアップ項目の種類を指定します。 現在、サポートされている値は AzureVM のみです。
型: | String |
承認された値: | AzureVM |
Position: | 2 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Vault
バックアップ ポリシーが属する Azure Backup コンテナーを指定します。 AzureRmBackupVault オブジェクトを取得するには、Get-AzureRmBackupVault コマンドレットを使用します。
型: | AzureRMBackupVault |
Position: | 0 |
既定値: | None |
必須: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Weekly
バックアップ ポリシーが週に 1 日または複数の曜日にトリガーされることを示します。
型: | SwitchParameter |
Position: | 4 |
既定値: | None |
必須: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
String[]
AzureRMBackupRetentionPolicy[]
パラメーター: コンテナー (ByValue)
出力
メモ
- なし