azure-automation
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure Automation Skill
Azure Automation Skill
This skill provides expert guidance for Azure Automation. Covers troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
本Skill为Azure Automation提供专业指导,涵盖故障排除、最佳实践、决策制定、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地快速参考内容与远程文档获取能力。
How to Use This Skill
如何使用本Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
Agent重要提示:使用下方的分类索引定位相关章节。对于带有行范围的分类(例如),使用L35-L120并指定对应行。对于带有文件链接的分类(例如read_file),对链接的参考文件使用[security.md](security.md)read_file
本Skill需要网络访问权限以获取文档内容:
- 首选方式:使用,查询字符串为
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备选方式:使用,查询字符串为
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L36-L46 | Diagnosing and fixing Azure Automation issues: DSC/State Configuration, Hybrid Runbook Workers (agent/extension), managed identities, runbook failures, shared resources, and collecting support diagnostics. |
| Best Practices | L47-L56 | Best practices for structuring, chaining, and managing runbooks, handling errors and output streams, ensuring resilient execution, and avoiding context-switching issues in Azure Automation. |
| Decision Making | L57-L66 | Guidance on choosing Azure Automation runbook types and planning migrations (Orchestrator, Log Analytics agent, Hybrid workers, Run As accounts, AzureRM→Az, and agent-to-extension changes). |
| Limits & Quotas | L67-L74 | Limits, quotas, and version/support details for Azure Automation: DSC extension changes, Automation resource limits, subscription quotas, and Change Tracking/Inventory support with AMA. |
| Security | L75-L95 | Securing Automation accounts: identities (system/user-assigned), Entra auth, RBAC, encryption, private endpoints, policies, and safe use of credentials/certs in runbooks and Terraform. |
| Configuration | L96-L136 | Configuring Azure Automation runbooks and DSC: alerts, schedules, parameters, hybrid workers, source control, Python/PowerShell modules, policy, and Change Tracking/Inventory at scale. |
| Integrations & Coding Patterns | L137-L149 | Integrating Automation runbooks with Azure/AWS/Office 365/SQL, authenticating via identities/webhooks, deploying ARM, sending logs to Monitor, and emailing via SendGrid |
| Deployment | L150-L158 | Guides for deploying resilient Automation accounts and Hybrid Runbook Workers (Windows/Linux), using availability zones, DR planning, and CI/CD with DSC and Chocolatey. |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排除 | L36-L46 | 诊断并修复Azure Automation问题:DSC/状态配置、Hybrid Runbook Workers(代理/扩展)、托管标识、Runbook执行失败、共享资源,以及收集支持诊断数据。 |
| 最佳实践 | L47-L56 | Runbook的结构设计、链式调用与管理的最佳实践,错误处理与输出流配置,确保执行弹性,以及避免Azure Automation中的上下文切换问题。 |
| 决策制定 | L57-L66 | 选择Azure Automation Runbook类型的指导,以及迁移规划(Orchestrator、Log Analytics代理、混合工作器、Run As账户、AzureRM→Az、代理到扩展的变更)。 |
| 限制与配额 | L67-L74 | Azure Automation的限制、配额、版本与支持详情:DSC扩展变更、Automation资源限制、订阅配额,以及AMA的变更跟踪/清单支持。 |
| 安全 | L75-L95 | 保护Automation账户:标识(系统分配/用户分配)、Entra身份验证、RBAC、加密、专用终结点、策略,以及在Runbook和Terraform中安全使用凭据/证书。 |
| 配置 | L96-L136 | 配置Azure Automation Runbook和DSC:警报、计划、参数、混合工作器、源代码控制、Python/PowerShell模块、策略,以及大规模变更跟踪/清单。 |
| 集成与编码模式 | L137-L149 | 将Automation Runbook与Azure/AWS/Office 365/SQL集成,通过标识/Webhook进行身份验证,部署ARM模板,将日志发送到Monitor,以及通过SendGrid发送邮件 |
| 部署 | L150-L158 | 部署高可用Automation账户和Hybrid Runbook Workers(Windows/Linux)的指南,使用可用性区域、灾难恢复规划,以及结合DSC和Chocolatey的CI/CD。 |
Troubleshooting
故障排除
| 主题 | URL |
|---|---|
| 为Azure Automation支持案例收集诊断数据 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/collect-data-microsoft-azure-automation-case |
| 排查Azure Automation状态配置问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/desired-state-configuration |
| 排查基于扩展的Hybrid Runbook Worker问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/extension-based-hybrid-runbook-worker |
| 排查基于代理的Hybrid Runbook Worker问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/hybrid-runbook-worker |
| 排查Azure Automation中的托管标识问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/managed-identity |
| 排查Azure Automation Runbook执行问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/runbooks |
| 排查Azure Automation共享资源问题 | https://learn.microsoft.com/en-us/azure/automation/troubleshoot/shared-resources |
Best Practices
最佳实践
| Topic | URL |
|---|---|
| Design modular parent-child runbooks in Azure Automation | https://learn.microsoft.com/en-us/azure/automation/automation-child-runbooks |
| Design resilient Azure Automation runbook execution behavior | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-execution |
| Implement error handling in Azure Automation graphical runbooks | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-graphical-error-handling |
| Configure output and message streams in Azure Automation runbooks | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-output-and-messages |
| Avoid Azure Automation runbook issues from context switching | https://learn.microsoft.com/en-us/azure/automation/context-switching |
| Manage Azure Automation runbooks with recommended design patterns | https://learn.microsoft.com/en-us/azure/automation/manage-runbooks |
| 主题 | URL |
|---|---|
| 在Azure Automation中设计模块化父子Runbook | https://learn.microsoft.com/en-us/azure/automation/automation-child-runbooks |
| 设计高可用的Azure Automation Runbook执行机制 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-execution |
| 在Azure Automation图形化Runbook中实现错误处理 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-graphical-error-handling |
| 配置Azure Automation Runbook的输出与消息流 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-output-and-messages |
| 避免Azure Automation Runbook因上下文切换产生的问题 | https://learn.microsoft.com/en-us/azure/automation/context-switching |
| 使用推荐设计模式管理Azure Automation Runbook | https://learn.microsoft.com/en-us/azure/automation/manage-runbooks |
Decision Making
决策制定
| Topic | URL |
|---|---|
| Migrate System Center Orchestrator runbooks to Azure Automation | https://learn.microsoft.com/en-us/azure/automation/automation-orchestrator-migration |
| Choose appropriate Azure Automation runbook types | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-types |
| Migrate Change Tracking from Log Analytics agent to AMA | https://learn.microsoft.com/en-us/azure/automation/change-tracking/guidance-migration-log-analytics-monitoring-agent |
| Migrate agent-based Hybrid Runbook Workers to extension-based workers | https://learn.microsoft.com/en-us/azure/automation/migrate-existing-agent-based-hybrid-worker-to-extension-based-workers |
| Plan and execute migration from Run As to managed identities | https://learn.microsoft.com/en-us/azure/automation/migrate-run-as-accounts-managed-identity |
| Plan migration from AzureRM to Az modules in Azure Automation | https://learn.microsoft.com/en-us/azure/automation/shared-resources/modules |
| 主题 | URL |
|---|---|
| 将System Center Orchestrator Runbook迁移到Azure Automation | https://learn.microsoft.com/en-us/azure/automation/automation-orchestrator-migration |
| 选择合适的Azure Automation Runbook类型 | https://learn.microsoft.com/en-us/azure/automation/automation-runbook-types |
| 将变更跟踪从Log Analytics代理迁移到AMA | https://learn.microsoft.com/en-us/azure/automation/change-tracking/guidance-migration-log-analytics-monitoring-agent |
| 将基于代理的Hybrid Runbook Worker迁移到基于扩展的工作器 | https://learn.microsoft.com/en-us/azure/automation/migrate-existing-agent-based-hybrid-worker-to-extension-based-workers |
| 规划并执行从Run As账户到托管标识的迁移 | https://learn.microsoft.com/en-us/azure/automation/migrate-run-as-accounts-managed-identity |
| 规划Azure Automation中从AzureRM到Az模块的迁移 | https://learn.microsoft.com/en-us/azure/automation/shared-resources/modules |
Limits & Quotas
限制与配额
| Topic | URL |
|---|---|
| Azure DSC extension version history and changes | https://learn.microsoft.com/en-us/azure/automation/automation-dsc-extension-history |
| View and manage Azure Automation limits and quotas | https://learn.microsoft.com/en-us/azure/automation/automation-limits-quotas |
| Azure Automation subscription limits and quotas reference | https://learn.microsoft.com/en-us/azure/automation/automation-subscription-limits-faq |
| Support matrix for Change Tracking and Inventory with AMA | https://learn.microsoft.com/en-us/azure/azure-change-tracking-inventory/change-tracking-inventory-support-matrix |
| 主题 | URL |
|---|---|
| Azure DSC扩展版本历史与变更 | https://learn.microsoft.com/en-us/azure/automation/automation-dsc-extension-history |
| 查看和管理Azure Automation的限制与配额 | https://learn.microsoft.com/en-us/azure/automation/automation-limits-quotas |
| Azure Automation订阅限制与配额参考 | https://learn.microsoft.com/en-us/azure/automation/automation-subscription-limits-faq |
| AMA的变更跟踪与清单支持矩阵 | https://learn.microsoft.com/en-us/azure/azure-change-tracking-inventory/change-tracking-inventory-support-matrix |
Security
安全
Configuration
配置
Integrations & Coding Patterns
集成与编码模式
Deployment
部署
| Topic | URL |
|---|---|
| Use availability zones for resilient Azure Automation deployments | https://learn.microsoft.com/en-us/azure/automation/automation-availability-zones |
| Plan disaster recovery for Azure Automation accounts | https://learn.microsoft.com/en-us/azure/automation/automation-disaster-recovery |
| Set up continuous deployment with DSC and Chocolatey | https://learn.microsoft.com/en-us/azure/automation/automation-dsc-cd-chocolatey |
| Deploy Linux Hybrid Runbook Worker agent | https://learn.microsoft.com/en-us/azure/automation/automation-linux-hrw-install |
| Deploy agent-based Windows Hybrid Runbook Workers in Azure Automation | https://learn.microsoft.com/en-us/azure/automation/automation-windows-hrw-install |
| Deploy extension-based Hybrid Runbook Workers for Windows and Linux | https://learn.microsoft.com/en-us/azure/automation/extension-based-hybrid-runbook-worker-install |
| 主题 | URL |
|---|---|
| 使用可用性区域实现高可用的Azure Automation部署 | https://learn.microsoft.com/en-us/azure/automation/automation-availability-zones |
| 规划Azure Automation账户的灾难恢复 | https://learn.microsoft.com/en-us/azure/automation/automation-disaster-recovery |
| 结合DSC和Chocolatey设置持续部署 | https://learn.microsoft.com/en-us/azure/automation/automation-dsc-cd-chocolatey |
| 部署Linux Hybrid Runbook Worker代理 | https://learn.microsoft.com/en-us/azure/automation/automation-linux-hrw-install |
| 在Azure Automation中部署基于代理的Windows Hybrid Runbook Worker | https://learn.microsoft.com/en-us/azure/automation/automation-windows-hrw-install |
| 部署适用于Windows和Linux的基于扩展的Hybrid Runbook Worker | https://learn.microsoft.com/en-us/azure/automation/extension-based-hybrid-runbook-worker-install |