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 との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EndDate
日付範囲の末尾を指定します。
| Type: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsReadyForMove
RP がターゲット 層に移動する準備ができているかどうかに基づいて回復ポイントをフィルター処理します。 これをターゲット層パラメーターと共に使用します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Item
このコマンドレットが復旧ポイントを取得する項目を指定します。 AzureRmRecoveryServicesBackupItem オブジェクトを取得するには、Get-AzRecoveryServicesBackupItem コマンドレットを使用します。
| Type: | ItemBase |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-KeyFileDownloadLocation
暗号化された仮想マシンの KeyVault キーを復元する入力ファイルをダウンロードする場所を指定します。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecoveryPointId
復旧ポイント ID を指定します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
日付範囲の開始を指定します。
| Type: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TargetTier
復旧ポイントの準備状態を移動チェックターゲット 層。 現在、有効な値は 'VaultArchive' のみです。
| Type: | RecoveryPointTier |
| Accepted values: | VaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tier
階層の値に基づいて復旧ポイントをフィルター処理します。
| Type: | RecoveryPointTier |
| Accepted values: | VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseSecondaryRegion
リージョン間復元のセカンダリ リージョンからのフィルター
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
Recovery Services コンテナーの ARM ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
入力
出力
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示