Feature: Enable PowerShell for Instant Access Restore Point by OMJayswal · Pull Request #29475 · Azure/azure-powershell

OMJayswal · 2026-04-28T18:11:06Z

Adds Instant Access (IA) parameters to existing Restore Point cmdlets, enabling rapid disk restoration from application-consistent snapshots on Premium SSD v2 and Ultra disks. Requires API version 2025-04-01+ and the AppConsistentInstantAccessSnapshotForDirectDriveDisks feature flag.

Changes

New parameters

New-AzRestorePointCollection: -InstantAccess <bool?> — enables IA at the collection level
Update-AzRestorePointCollection: -InstantAccess <bool?> — toggles IA on an existing collection via PATCH
New-AzRestorePoint: -InstantAccessDurationInMinutes <int?> — IA snapshot retention duration (validated 1–300 min)

Output type additions

PSRestorePointCollection: InstantAccess (bool?) — mapped from RestorePointCollection.InstantAccess
PSRestorePoint: InstantAccessDurationInMinutes (int?) — custom AutoMapper mapping from SDK's InstantAccessDurationMinutes

Supporting changes

AutoMapper profile updated with explicit InstantAccessDurationMinutes → InstantAccessDurationInMinutes mapping
Help docs updated for all three cmdlets with new parameter docs and examples
Scenario test Test-RestorePointsInstantAccess added covering collection creation with IA, restore point with custom duration, output property verification, and IA toggle via Update

Usage

# Create collection with Instant Access enabled
New-AzRestorePointCollection -ResourceGroupName "rg" -Name "rpc" -VmId $vm.Id -Location "eastus2euap" -InstantAccess $true

# Create restore point with 120-min IA duration
New-AzRestorePoint -ResourceGroupName "rg" -RestorePointCollectionName "rpc" -Name "rp1" `
    -ConsistencyMode "ApplicationConsistent" -InstantAccessDurationInMinutes 120

# Disable IA on existing collection
Update-AzRestorePointCollection -ResourceGroupName "rg" -Name "rpc" -InstantAccess $false

All new parameters are optional; omitting them preserves existing behavior.

…w/Update-AzRestorePointCollection Agent-Logs-Url: https://github.com/OMJayswal/azure-powershell/sessions/293138a6-53c0-42e4-b3cb-60d044135327 Co-authored-by: OMJayswal <146695766+OMJayswal@users.noreply.github.com>

- Update Test-RestorePointsInstantAccess to use eastus2euap (only region supporting InstantAccess), Win2019Datacenter image (Win2012R2Datacenter retired), and correct VM setup without policy-blocked configurations - Create restore point collection with -InstantAccess \True - Create restore point with -InstantAccessDurationInMinutes 120 - Remove assertions on InstantAccessDurationInMinutes since the Azure API accepts it on write but does not return it in GET responses - Add session recording for playback Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

azure-client-tools-bot-prd · 2026-04-28T18:11:10Z

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

…ints

Copilot

Pull request overview

This PR adds PowerShell support for configuring Instant Access behavior on restore point collections and restore points in the Az.Compute module, including cmdlet parameters, output surface area updates, and scenario test coverage.

Changes:

Added -InstantAccess to New-AzRestorePointCollection and Update-AzRestorePointCollection.
Added -InstantAccessDurationInMinutes to New-AzRestorePoint and surfaced corresponding output properties via PS models and AutoMapper.
Updated help docs, changelog, and added a new scenario test for Instant Access.

Reviewed changes

Copilot reviewed 9 out of 13 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/Compute/Compute/help/Update-AzRestorePointCollection.md	Documents new `-InstantAccess` parameter and example.
src/Compute/Compute/help/New-AzRestorePointCollection.md	Documents new `-InstantAccess` parameter and example.
src/Compute/Compute/help/New-AzRestorePoint.md	Documents new `-InstantAccessDurationInMinutes` parameter and example.
src/Compute/Compute/RestorePoints/UpdateAzRestorePointCollection.cs	Adds `InstantAccess` parameter and passes it to RPC update.
src/Compute/Compute/RestorePoints/NewAzRestorePointCollection.cs	Adds `InstantAccess` parameter and sets it on create.
src/Compute/Compute/RestorePoints/NewAzRestorePoint.cs	Adds duration parameter with validation and sets SDK model field.
src/Compute/Compute/Generated/Models/PSRestorePointCollection.cs	Adds `InstantAccess` property to output type.
src/Compute/Compute/Generated/Models/PSRestorePoint.cs	Adds `InstantAccessDurationInMinutes` property to output type.
src/Compute/Compute/Generated/Models/ComputeAutoMapperProfile.cs	Maps SDK `InstantAccessDurationMinutes` to PS `InstantAccessDurationInMinutes`.
src/Compute/Compute/ChangeLog.md	Adds release notes entries for the new parameters/properties.
src/Compute/Compute.Test/ScenarioTests/RestorePointsTests.ps1	Adds new `Test-RestorePointsInstantAccess` scenario script.
src/Compute/Compute.Test/ScenarioTests/RestorePointsTests.cs	Wires the new scenario script into xUnit.

VeryEarly · 2026-04-28T18:42:43Z

/azp run

azure-pipelines · 2026-04-28T18:43:00Z

Azure Pipelines successfully started running 3 pipeline(s).

audreyttt

Looks good to me with some small nits. Please look into the CI check failure logs and follow any remediation steps.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 9 out of 13 changed files in this pull request and generated 4 comments.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 9 out of 13 changed files in this pull request and generated 3 comments.

VeryEarly · 2026-04-30T06:50:05Z

/azp run

azure-pipelines · 2026-04-30T06:50:23Z

Azure Pipelines successfully started running 3 pipeline(s).

mask characters of password with *** Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 9 out of 13 changed files in this pull request and generated 6 comments.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

VeryEarly · 2026-05-05T01:42:13Z

/azp run

azure-pipelines · 2026-05-05T01:42:29Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 9 out of 13 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

src/Compute/Compute/help/New-AzRestorePoint.md:45

Example 2 does not specify -ConsistencyMode, but the example description claims it creates an application-consistent restore point, while the -ConsistencyMode parameter description below says only CrashConsistent is accepted as input. Please update the example description (or the parameter description) so the documented behavior is consistent.

### Example 2
```powershell
New-AzRestorePoint -ResourceGroupName "MyResourceGroup" -RestorePointCollectionName "MyRPCollection" -Name "MyRestorePoint" -InstantAccessDurationInMinutes 120

Creates a new application-consistent Restore Point with a 120-minute instant access snapshot duration.

PARAMETERS

-ConsistencyMode

ConsistencyMode of the restore point. Can be specified in the input while creating a restore point. For now, only CrashConsistent is accepted as a valid input. Please refer to https://aka.ms/RestorePoints for more details.

</details>

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 9 out of 13 changed files in this pull request and generated 7 comments.

VeryEarly · 2026-05-05T10:38:26Z

/azp run

azure-pipelines · 2026-05-05T10:38:44Z

Azure Pipelines successfully started running 3 pipeline(s).

audreyttt

Please also accept the CLA agreement following the instructions in the microsoft-github-policy-service comment, to resolve the CI check.

audreyttt · 2026-05-05T18:04:01Z

/azp run

azure-pipelines · 2026-05-05T18:04:20Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot AI and others added 5 commits April 17, 2026 09:46

Initial plan

375dbc8

fix issue

a7f6442

dummy commit

4c1a13e

Copilot AI review requested due to automatic review settings April 28, 2026 18:11

OMJayswal requested review from NoriZC, audreyttt, haagha, ookoka, teresaritorto and yanzhudd as code owners April 28, 2026 18:11

Copilot started reviewing on behalf of OMJayswal April 28, 2026 18:13 View session

Merge branch 'main' into copilot/az-compute-instant-access-restore-po…

7b4698e

…ints

Copilot AI reviewed Apr 28, 2026

View reviewed changes

Comment thread src/Compute/Compute/help/New-AzRestorePoint.md

Comment thread src/Compute/Compute.Test/ScenarioTests/RestorePointsTests.ps1

Comment thread src/Compute/Compute/ChangeLog.md Outdated

Comment thread src/Compute/Compute.Test/ScenarioTests/RestorePointsTests.cs Outdated

audreyttt requested changes Apr 29, 2026

View reviewed changes

Comment thread src/Compute/Compute/help/New-AzRestorePoint.md

Comment thread src/Compute/Compute/ChangeLog.md Outdated

Update src/Compute/Compute.Test/ScenarioTests/RestorePointsTests.cs

5a3eed3

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings April 30, 2026 06:22

Copilot started reviewing on behalf of OMJayswal April 30, 2026 06:24 View session

Copilot AI reviewed Apr 30, 2026

View reviewed changes

Update src/Compute/Compute/help/New-AzRestorePointCollection.md

03dfb68

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings April 30, 2026 06:34

Copilot started reviewing on behalf of OMJayswal April 30, 2026 06:36 View session

Copilot AI reviewed Apr 30, 2026

View reviewed changes

Comment thread src/Compute/Compute/help/Update-AzRestorePointCollection.md Outdated

Comment thread src/Compute/Compute/ChangeLog.md Outdated

Comment thread src/Compute/Compute.Test/ScenarioTests/RestorePointsTests.ps1

Apply suggestion from @Copilot

92d7d55

mask characters of password with *** Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

changeLogFix

7e1f14d

Copilot AI review requested due to automatic review settings May 5, 2026 01:31

OMJayswal dismissed haagha’s stale review via 7e1f14d May 5, 2026 01:31

Copilot AI reviewed May 5, 2026

View reviewed changes

Potential fix for pull request finding

a606e45

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings May 5, 2026 01:37

Copilot started reviewing on behalf of OMJayswal May 5, 2026 01:39 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

Comment thread src/Compute/Compute.Test/ScenarioTests/RestorePointsTests.ps1 Outdated

Potential fix for pull request finding

0d614ea

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings May 5, 2026 10:10

Copilot started reviewing on behalf of OMJayswal May 5, 2026 10:12 View session

Copilot AI reviewed May 5, 2026

View reviewed changes

haagha requested a review from audreyttt May 5, 2026 14:30

haagha previously approved these changes May 5, 2026

View reviewed changes

audreyttt previously approved these changes May 5, 2026

View reviewed changes

Comment thread src/Compute/Compute/help/New-AzRestorePoint.md Outdated

Comment thread src/Compute/Compute/help/Update-AzRestorePointCollection.md Outdated

Comment thread src/Compute/Compute/ChangeLog.md Outdated

Comment thread src/Compute/Compute/Generated/Models/PSRestorePoint.cs Outdated

audreyttt modified the milestone: Az 16.0.0 (06/02/2026) May 5, 2026

resolve-comments

d06f47f

OMJayswal dismissed stale reviews from audreyttt and haagha via d06f47f May 5, 2026 17:51

audreyttt approved these changes May 5, 2026

View reviewed changes

YanaXu enabled auto-merge (squash) May 6, 2026 07:09

YanaXu disabled auto-merge May 6, 2026 07:12

YanaXu merged commit 3ade6e3 into Azure:main May 6, 2026
11 of 12 checks passed

Conversation

OMJayswal commented Apr 28, 2026 • edited by audreyttt Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Usage

Uh oh!

azure-client-tools-bot-prd Bot commented Apr 28, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

VeryEarly commented Apr 28, 2026

Uh oh!

azure-pipelines Bot commented Apr 28, 2026

Uh oh!

audreyttt left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

VeryEarly commented Apr 30, 2026

Uh oh!

azure-pipelines Bot commented Apr 30, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

VeryEarly commented May 5, 2026

Uh oh!

azure-pipelines Bot commented May 5, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

PARAMETERS

-ConsistencyMode

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

VeryEarly commented May 5, 2026

Uh oh!

azure-pipelines Bot commented May 5, 2026

OMJayswal commented Apr 28, 2026 •

edited by audreyttt

Loading