Changes for Restore documentation by amdeocha · Pull Request #4262 · MicrosoftDocs/azure-stack-docs

amdeocha · 2026-04-23T14:34:03Z

Changes for Restore documentation

Restore changes

prmerger-automator · 2026-04-23T14:34:18Z

@amdeocha : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

learn-build-service-prod · 2026-04-23T14:36:23Z

Learn Build status updates of commit 438a258:

✅ Validation status: passed

File	Status	Preview URL	Details
azure-local/manage/disconnected-operations-back-up-restore.md	✅Succeeded
azure-local/manage/disconnected-operations-restore.md	✅Succeeded
azure-local/manage/media/disconnected-operations/back-up-restore/get-appliance-restore.png	✅Succeeded
azure-local/manage/media/disconnected-operations/back-up-restore/trigger-restore.png	✅Succeeded
azure-local/manage/media/disconnected-operations/back-up-restore/wait-appliance-restore.png	✅Succeeded
azure-local/TOC.yml	✅Succeeded

For more details, please refer to the build report.

prmerger-automator · 2026-04-23T14:36:29Z

PRMerger Results

Issue	Description
Added File(s)	This PR contains added files. New files require human review.
Yaml File(s)	This PR includes changes to .yml file(s) owned by another author.
File Change Percent	This PR contains file(s) with more than 30% file change.
Image File	This PR added or updated an image file(s).

v-regandowner · 2026-04-23T15:15:59Z

@ronmiab

If you approve the new content in this PR, the commits must be moved to the private repository for automated checks and publishing. After you move the commits, close this PR (#please-close). If you need help moving the commits, contact the publicprs alias.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

Copilot

Pull request overview

Adds initial “Restore” documentation for Azure Local disconnected operations and updates navigation/backup docs accordingly.

Changes:

Adds a new restore how-to/concept article for disconnected operations.
Updates the backup article title and removes the “restore is in development” disclaimer.
Adds the new restore article to the Azure Local TOC under Disconnected operations.

Reviewed changes

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

File	Description
azure-local/manage/disconnected-operations-restore.md	New restore documentation (cmdlets, prerequisites, post-restore caveats) gated by monikers.
azure-local/manage/disconnected-operations-back-up-restore.md	Updates page metadata title and removes restore-in-development notice.
azure-local/TOC.yml	Adds TOC entry linking to the new restore article.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-04-23T15:27:19Z

+
+# Restore for disconnected operations for Azure Local
+
+::: moniker range=">=azloc-2602"


The moniker range starts at ">=azloc-2602", but the feature note below says restore is only available in Azure Local 2603+. As written, the restore content will render for azloc-2602 (and also overlaps with the fallback moniker), which is misleading. Update the content moniker to start at the correct version (likely ">=azloc-2603") so it doesn’t display for 2602.

Suggested change

::: moniker range=">=azloc-2602"

::: moniker range=">=azloc-2603"

Copilot · 2026-04-23T15:27:19Z

+
+::: moniker-end
+
+::: moniker range="<=azloc-2602"


The fallback moniker range overlaps the main content moniker (both include azloc-2602), so users on 2602 can see both the restore instructions and the "2603 or later" warning. Adjust the fallback moniker to avoid overlap (for example, use "<azloc-2603", consistent with azure-local/manage/manage-secure-boot-updates.md:230).

Suggested change

::: moniker range="<=azloc-2602"

::: moniker range="<azloc-2603"

Copilot · 2026-04-23T15:27:20Z

+  Import-Module "<full path to Operations Module>\Azure.Local.Restore.psm1"
+  ```
+
+## Trigger and monitor a backup


Section heading says "Trigger and monitor a backup" but the section content and commands are for restore. Rename the heading to "Trigger and monitor a restore" to avoid confusing readers.

Suggested change

## Trigger and monitor a backup

## Trigger and monitor a restore

Copilot · 2026-04-23T15:27:20Z

+> [!IMPORTANT]
+> The restore operation supports restoring the backup to the same version of Azure local disconnected environment.
+
+## Overview
+
+The backup feature currently backs up only the control plane VM data. It doesn't include associated workloads or configured clusters. The restore functionality restores the control plane data from the backup. So, ensure that you configure the same version of Azure local disconnected where you restore the backup.


In this IMPORTANT note and the following paragraph, "Azure local" is inconsistently cased compared to "Azure Local" elsewhere in the article/title. Please standardize the product name casing (and related phrasing) so readers don’t interpret it as a different term.

Copilot · 2026-04-23T15:27:20Z

+- **Environment Setup:** Ensure that you have a fresh Azure local Disconnected environment that you set up and that the version matches the backup version. Cross version restores aren't supported.
+
+- **Root Certificate:** For the Restore VM, ensure that the same Root Certificate - Certificate Authority is used for the new VM Creation to ensure the trust.
+


These prerequisites have multiple capitalization/grammar issues (for example "Azure local Disconnected", "Cross version", and "new VM Creation") that make the steps harder to follow. Please standardize capitalization ("Azure Local disconnected"), use the hyphenated form ("cross-version"), and rephrase the root certificate requirement more clearly.

Copilot · 2026-04-23T15:27:20Z

    - name: Back up disconnected operations
      href: manage/disconnected-operations-back-up-restore.md
+    - name: Restore disconnected operations
+      href: manage/disconnected-operations-restore.md  


This TOC line has trailing whitespace after the href value. Please remove trailing spaces to avoid YAML/markdown lint noise and unnecessary diffs.

Suggested change

href: manage/disconnected-operations-restore.md

href: manage/disconnected-operations-restore.md

ronmiab · 2026-04-27T19:19:31Z

#please-close

Files fixed in private repo: https://github.com/MicrosoftDocs/azure-stack-docs-pr/pull/20631

amdeocha added 4 commits April 23, 2026 17:45

Add files via upload

b341dc3

Add restore option for disconnected operations

419ac3b

Add files via upload

2dc1964

Merge pull request #1 from amdeocha/amdeocha-restore

438a258

Restore changes

prmerger-automator Bot added the do-not-merge label Apr 23, 2026

prmerger-automator Bot assigned ronmiab Apr 23, 2026

prmerger-automator Bot requested a review from ronmiab April 23, 2026 14:34

prmerger-automator Bot added azure-local/svc Change sent to author hyperconverged/subsvc labels Apr 23, 2026

prmerger-automator Bot added the needs-human-review label Apr 23, 2026

prmerger-automator Bot added the aq-pr-triaged Tracking label for the PR review team label Apr 23, 2026

v-regandowner requested a review from Copilot April 23, 2026 15:17

Copilot started reviewing on behalf of v-regandowner April 23, 2026 15:21 View session

Copilot AI reviewed Apr 23, 2026

View reviewed changes

prmerger-automator Bot closed this Apr 27, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Changes for Restore documentation#4262

Changes for Restore documentation#4262
amdeocha wants to merge 4 commits intoMicrosoftDocs:mainfrom
amdeocha:main

amdeocha commented Apr 23, 2026

Uh oh!

prmerger-automator Bot commented Apr 23, 2026

Uh oh!

learn-build-service-prod Bot commented Apr 23, 2026

Uh oh!

prmerger-automator Bot commented Apr 23, 2026

Uh oh!

v-regandowner commented Apr 23, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Apr 23, 2026

Uh oh!

Copilot AI Apr 23, 2026

Uh oh!

Copilot AI Apr 23, 2026

Uh oh!

Copilot AI Apr 23, 2026

Uh oh!

Copilot AI Apr 23, 2026

Uh oh!

Copilot AI Apr 23, 2026

Uh oh!

ronmiab commented Apr 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants


		# Restore for disconnected operations for Azure Local

		::: moniker range=">=azloc-2602"

	::: moniker range=">=azloc-2602"
	::: moniker range=">=azloc-2603"

	::: moniker range="<=azloc-2602"
	::: moniker range="<azloc-2603"

	## Trigger and monitor a backup
	## Trigger and monitor a restore

		- Environment Setup: Ensure that you have a fresh Azure local Disconnected environment that you set up and that the version matches the backup version. Cross version restores aren't supported.

		- Root Certificate: For the Restore VM, ensure that the same Root Certificate - Certificate Authority is used for the new VM Creation to ensure the trust.

	href: manage/disconnected-operations-restore.md
	href: manage/disconnected-operations-restore.md

Conversation

amdeocha commented Apr 23, 2026

Uh oh!

prmerger-automator Bot commented Apr 23, 2026

Uh oh!

learn-build-service-prod Bot commented Apr 23, 2026

✅ Validation status: passed

Uh oh!

prmerger-automator Bot commented Apr 23, 2026

PRMerger Results

Uh oh!

v-regandowner commented Apr 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

ronmiab commented Apr 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants