About azure-site-recovery
azure-site-recovery is a guidance skill for agents supporting Azure Site Recovery planning and operations. It combines local quick references with network-based documentation fetching, covering deployment, configuration, security, and troubleshooting.
Key features
- 01Troubleshooting across Azure, Hyper-V, and VMware
- 02Disaster recovery planning and capacity estimates
- 03Architecture, security, and configuration guidance
- 04Automation and integration coding patterns
- 05Fetches Microsoft documentation over the network
Use cases
- 01Diagnose replication, connectivity, or failover issues
- 02Plan VM disaster recovery capacity and costs
- 03Design protected application and network architectures
MCP support
Documentation can be fetched with the mcp_microsoftdocs microsoft_docs_fetch tool; fetch_webpage is listed as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-site-recoveryAfter installing, type/azure-site-recoveryin Claude Code to confirm it loaded.
Details
From the project READMEAzure Site Recovery Skill
This skill provides expert guidance for Azure Site Recovery. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L61 | Diagnosing and fixing Azure Site Recovery issues across Azure, Hyper-V, and VMware: replication, connectivity, agents/extensions, appliances, failover/failback, and common error codes. |
| Best Practices | L62-L68 | Best practices for preparing on-prem disks for ASR, reducing high data churn on protected VMs, and monitoring/tuning process server health and performance. |
| Decision Making | L69-L86 | Planning and sizing Azure Site Recovery for DR: choosing tools (ASR vs Azure Migrate), VM sizes, failback types, managed disk and DR costs, and using/reading Deployment Planner reports for Hyper-V/VMware. |
| Architecture & Design Patterns | L87-L98 | Design patterns and reference architectures for using Azure Site Recovery to protect networks and complex apps (SAP, SharePoint, IIS, Dynamics AX, SQL, file servers) and build end-to-end DR solutions. |
| Limits & Quotas | L99-L107 | Limits, quotas, and constraints for Site Recovery: high-churn VM limits, shared disk support, safe coexistence with Backup, Deployment Planner limits/history, and Mobility service resource usage. |
| Security | L108-L120 | Encrypting and securing ASR: handling ADE/CMK-encrypted VMs, NSGs, TLS, RBAC, trusted launch, VMware-to-Azure security, and replacing legacy Run As/encryption setups |
| Configuration | L121-L162 | Configuring Azure Site Recovery for VMware/Hyper-V/Azure VMs: networking, IPs, disks, appliances, policies, monitoring, and DR setup for AVS, Extended Zones, and shared/clustered workloads. |
| Integrations & Coding Patterns | L163-L179 | Automating and integrating Azure Site Recovery using PowerShell, ARM/Bicep/Terraform, ExpressRoute, Traffic Manager, and runbooks, including Hyper-V, VMware, shared disk, and Azure VM DR setups. |
| Deployment | L180-L191 | Guides for setting up and managing ASR replication/migration (Azure VMs, VMware, Hyper-V, physical), including support matrices, appliances, and failover/failback workflows. |
Troubleshooting
Best Practices
| Topic | URL |
|---|---|
| Prepare on-premises disks for Azure hydration | https://learn.microsoft.com/en-us/azure/site-recovery/hydration-process |
| Analyze and mitigate high churn patterns on Site Recovery VMs | https://learn.microsoft.com/en-us/azure/site-recovery/monitoring-high-churn |
| Monitor Azure Site Recovery process server health and performance | https://learn.microsoft.com/en-us/azure/site-recovery/vmware-physical-azure-monitor-process-server |
Decision Making
Architecture & Design Patterns
Limits & Quotas
| Topic | URL |
|---|---|
| Apply high churn limits for Azure VM DR | https://learn.microsoft.com/en-us/azure/site-recovery/concepts-azure-to-azure-high-churn-support |
| Understand shared disk support for Site Recovery | https://learn.microsoft.com/en-us/azure/site-recovery/shared-disk-support-matrix |
| Use Azure Site Recovery with Azure Backup safely | https://learn.microsoft.com/en-us/azure/site-recovery/site-recovery-backup-interoperability |
| Review version history and limitations of Site Recovery Deployment Planner | https://learn.microsoft.com/en-us/azure/site-recovery/site-recovery-deployment-planner-history |
| Understand Mobility service resource usage for Site Recovery | https://learn.microsoft.com/en-us/azure/site-recovery/vmware-physical-mobility-service-overview |