Get-AzRecoveryServicesBackupRecoveryPoint
バックアップされた項目の復旧ポイントを取得します。
構文
Get-AzRecoveryServicesBackupRecoveryPoint
[-Item] <ItemBase>
[-UseSecondaryRegion]
[-Tier <RecoveryPointTier>]
[-IsReadyForMove <Boolean>]
[-TargetTier <RecoveryPointTier>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzRecoveryServicesBackupRecoveryPoint
[[-StartDate] <DateTime>]
[[-EndDate] <DateTime>]
[-Item] <ItemBase>
[-UseSecondaryRegion]
[-Tier <RecoveryPointTier>]
[-IsReadyForMove <Boolean>]
[-TargetTier <RecoveryPointTier>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzRecoveryServicesBackupRecoveryPoint
[-Item] <ItemBase>
[-RecoveryPointId] <String>
[[-KeyFileDownloadLocation] <String>]
[-UseSecondaryRegion]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
Get-AzRecoveryServicesBackupRecoveryPoint コマンドレットは、バックアップされた Azure Backup 項目の復旧ポイントを取得します。 項目がバックアップされると、 AzureRmRecoveryServicesBackupRecoveryPoint オブジェクトには 1 つ以上の回復ポイントがあります。 -VaultId パラメーターを使用してコンテナー コンテキストを設定します。
例
例 1: 項目の先週の復旧ポイントを取得する
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7)
$endDate = Get-Date
$container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVM -FriendlyName "V2VM" -VaultId $vault.ID
$backupItem = Get-AzRecoveryServicesBackupItem -Container $container -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -Item $backupItem -StartDate $startdate.ToUniversalTime() -EndDate $enddate.ToUniversalTime() -VaultId $vault.ID最初のコマンドは、vaultName に基づいてコンテナー オブジェクトを取得します。 2 番目のコマンドは、7 日前の日付を取得し、$startDate変数に格納します。 3 番目のコマンドは今日の日付を取得し、$endDate変数に格納します。 4 番目のコマンドは、AzureVM バックアップ コンテナーを取得し、$Container変数に格納します。 5 番目のコマンドは、workloadType、vaultId に基づいてバックアップ項目を取得し、$backupItem変数に格納します。 最後のコマンドは、$BackupItem内の項目の回復ポイントの配列を取得し、それらを$rp変数に格納します。
例 2: VaultArchive に移動する準備ができている復旧ポイントを取得する
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate $startDate -EndDate $endDate -VaultId $vault.ID -Item $item[3] `
-IsReadyForMove $true -TargetTier VaultArchive最初のコマンドは、vaultName に基づいてコンテナー オブジェクトを取得します。 2 番目のコマンドは、7 日前の日付を取得し、$startDate変数に格納します。 3 番目のコマンドは今日の日付を取得し、$endDate変数に格納します。 4 番目のコマンドは、backupManagementType と workloadType、vaultId に基づいてバックアップ項目を取得し、$item変数に格納します。 最後のコマンドは、VaultArchive レベルに移動する準備ができている$backupItem内の項目の復旧ポイントの配列を取得し、それらを$rp変数に格納します。
例 3: 特定のレベルの復旧ポイントを取得する
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate $startDate -EndDate $endDate -VaultId $vault.ID -Item $item[3] `
-Tier VaultStandard最初のコマンドは、vaultName に基づいてコンテナー オブジェクトを取得します。 2 番目のコマンドは、7 日前の日付を取得し、$startDate変数に格納します。 3 番目のコマンドは今日の日付を取得し、$endDate変数に格納します。 4 番目のコマンドは、backupManagementType と workloadType、vaultId に基づいてバックアップ項目を取得し、$item変数に格納します。 最後のコマンドは、VaultArchive レベルに移動する準備ができている$backupItem内の項目の復旧ポイントの配列を取得し、それらを$rp変数に格納します。
例 4: ポリシー操作を変更した後の昨年の排除された復旧ポイントの取得
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-365).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rpsBefore = Get-AzRecoveryServicesBackupRecoveryPoint -Item $item[0] -StartDate $startDate -EndDate $endDate -VaultId $vault.ID
# update policy
$pol = Get-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Name "policyName"
$pol.RetentionPolicy.IsWeeklyScheduleEnabled = $false
$pol.RetentionPolicy.IsMonthlyScheduleEnabled = $false
$pol.RetentionPolicy.IsYearlyScheduleEnabled = $false
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $pol -VaultId $vault.ID -RetentionPolicy $pol.RetentionPolicy -Debug
# wait until policy changes are applied to recovery points and they are pruned
$rpsAfter = Get-AzRecoveryServicesBackupRecoveryPoint -Item $item[0] -StartDate $startDate -EndDate $endDate -VaultId $vault.ID
# compare the recovery points list before and after
$diff = Compare-Object $rpsBefore $rpsAfter
$rpsRemoved = $diff | Where-Object{ $_.SideIndicator -eq'<='} | Select-Object -ExpandProperty InputObject
$rpsRemoved
RecoveryPointId RecoveryPointType RecoveryPointTime ContainerName ContainerType
--------------- ----------------- ----------------- ------------- -------------
7397781054902 CrashConsistent 5/2/2023 3:28:35 AM iaasvmcontainerv2;test-rg;test-vm AzureVM
9722704411921 CrashConsistent 4/1/2023 3:32:26 AM iaasvmcontainerv2;test-rg;test-vm AzureVM
6543100104464 CrashConsistent 3/1/2023 3:26:27 AM iaasvmcontainerv2;test-rg;test-vm AzureVM最初のコマンドは、vaultName に基づいてコンテナー オブジェクトを取得します。 2 番目のコマンドは、1 年前の日付を取得し、$startDate変数に格納します。 3 番目のコマンドは今日の日付を取得し、$endDate変数に格納します。 4 番目のコマンドは、backupManagementType と workloadType、vaultId に基づいてバックアップ項目を取得し、$item変数に格納します。 5 番目のコマンドは、過去 1 年間のポリシー変更操作の前に存在する$item内の項目の復旧ポイントの配列を取得します。 次に、ポリシーを更新します。 6 番目のコマンドは、更新するポリシーをフェッチします。このポリシーは、バックアップ項目 $item[0]を保護するために使用されます。 7 番目、8 番目、および 9 番目のコマンドは、ポリシーの年単位および月単位のリテンション期間を無効にして、古い復旧ポイントを排除します。 10 番目のコマンドは、最終的にアイテム保持ポリシーを更新します。 11 番目のコマンドは、復旧ポイントが排除されるまで同じ PowerShell セッションで待機し、ポリシーの変更が適用された後、同じ時間内に復旧ポイントをフェッチします。 twelth コマンドは、排除が行われる前と後の復旧ポイント リストの間で差分を取ります。 13 番目のコマンドは、前に存在していた差分から復旧ポイントを読み取り、現在は排除されています。 最後のコマンドは、排除された復旧ポイントの一覧を表示します。
パラメーター
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| 型: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EndDate
日付範囲の末尾を指定します。
| 型: | Nullable<T>[DateTime] |
| 配置: | 1 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IsReadyForMove
RP がターゲット 層に移動する準備ができているかどうかに基づいて回復ポイントをフィルター処理します。 これをターゲット層パラメーターと共に使用します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Item
このコマンドレットが復旧ポイントを取得する項目を指定します。 AzureRmRecoveryServicesBackupItem オブジェクトを取得するには、Get-AzRecoveryServicesBackupItem コマンドレットを使用します。
| 型: | ItemBase |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-KeyFileDownloadLocation
暗号化された仮想マシンの KeyVault キーを復元する入力ファイルをダウンロードする場所を指定します。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RecoveryPointId
復旧ポイント ID を指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-StartDate
日付範囲の開始を指定します。
| 型: | Nullable<T>[DateTime] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TargetTier
復旧ポイントの移動の準備状態を確認するターゲット 層。 現在、有効な値は 'VaultArchive' のみです。
| 型: | RecoveryPointTier |
| 指定可能な値: | VaultArchive |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Tier
階層の値に基づいて復旧ポイントをフィルター処理します。
| 型: | RecoveryPointTier |
| 指定可能な値: | VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseSecondaryRegion
リージョン間復元のセカンダリ リージョンからのフィルター
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VaultId
Recovery Services コンテナーの ARM ID。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell