Skip to content

Commit 074063a

Browse files
authored
Merge pull request #189387 from JnHs/jh-as-deploytoc
deploy toc update and topic refresh
2 parents 1e65824 + 5476e48 commit 074063a

File tree

3 files changed

+43
-32
lines changed

3 files changed

+43
-32
lines changed

articles/azure-arc/servers/agent-overview.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -100,7 +100,7 @@ The following versions of the Windows and Linux operating system are officially
100100
* Oracle Linux 7 (x64)
101101

102102
> [!WARNING]
103-
> The Linux hostname or Windows computer name cannot use one of the reserved words or trademarks in the name, otherwise attempting to register the connected machine with Azure will fail. See [Resolve reserved resource name errors](../../azure-resource-manager/templates/error-reserved-resource-name.md) for a list of the reserved words.
103+
> The Linux hostname or Windows computer name cannot use one of the reserved words or trademarks in the name, otherwise attempting to register the connected machine with Azure will fail. For a list of reserved words, see [Resolve reserved resource name errors](../../azure-resource-manager/templates/error-reserved-resource-name.md).
104104
105105
> [!NOTE]
106106
> While Azure Arc-enabled servers supports Amazon Linux, the following do not support this distribution:
@@ -137,7 +137,7 @@ Azure Arc-enabled servers depend on the following Azure resource providers in yo
137137
* **Microsoft.GuestConfiguration**
138138
* **Microsoft.HybridConnectivity**
139139

140-
If they are not registered, you can register them using the following commands:
140+
If these resource providers are not already registered, you can register them using the following commands:
141141

142142
Azure PowerShell:
143143

@@ -158,7 +158,7 @@ az provider register --namespace 'Microsoft.GuestConfiguration'
158158
az provider register --namespace 'Microsoft.HybridConnectivity'
159159
```
160160

161-
You can also register the resource providers in the Azure portal by following the steps under [Azure portal](../../azure-resource-manager/management/resource-providers-and-types.md#azure-portal).
161+
You can also register the resource providers in the [Azure portal](../../azure-resource-manager/management/resource-providers-and-types.md#azure-portal).
162162

163163
### Transport Layer Security 1.2 protocol
164164

@@ -203,31 +203,38 @@ URLs:
203203
|`dc.services.visualstudio.com`|Agent telemetry|
204204
|`guestnotificationservice.azure.com`, `*.guestnotificationservice.azure.com`|Notification service|
205205

206-
For a list of IP addresses for each service tag/region, see the JSON file - [Azure IP Ranges and Service Tags – Public Cloud](https://www.microsoft.com/download/details.aspx?id=56519). Microsoft publishes weekly updates containing each Azure Service and the IP ranges it uses. This information in the JSON file is the current point-in-time list of the IP ranges that correspond to each service tag. The IP addresses are subject to change. If IP address ranges are required for your firewall configuration, then the **AzureCloud** Service Tag should be used to allow access to all Azure services. Do not disable security monitoring or inspection of these URLs, allow them as you would other Internet traffic.
206+
For a list of IP addresses for each service tag/region, see the JSON file [Azure IP Ranges and Service Tags – Public Cloud](https://www.microsoft.com/download/details.aspx?id=56519). Microsoft publishes weekly updates containing each Azure Service and the IP ranges it uses. This information in the JSON file is the current point-in-time list of the IP ranges that correspond to each service tag. The IP addresses are subject to change. If IP address ranges are required for your firewall configuration, then the **AzureCloud** Service Tag should be used to allow access to all Azure services. Do not disable security monitoring or inspection of these URLs, allow them as you would other Internet traffic.
207207

208-
For more information, review [Service tags overview](../../virtual-network/service-tags-overview.md).
208+
For more information, see [Virtual network service tags](../../virtual-network/service-tags-overview.md).
209209

210210
## Installation and configuration
211211

212-
Connecting machines in your hybrid environment directly with Azure can be accomplished using different methods depending on your requirements. The following table highlights each method to determine which works best for your organization.
213-
214-
> [!IMPORTANT]
215-
> The Connected Machine agent cannot be installed on an Azure Windows virtual machine. If you attempt to, the installation detects this and rolls back.
212+
Connecting machines in your hybrid environment directly with Azure can be accomplished using different methods, depending on your requirements and the tools you prefer to use. The following table highlights each method so that you can determine which works best for your deployment.
216213

217214
| Method | Description |
218215
|--------|-------------|
219-
| Interactively | Manually install the agent on a single or small number of machines following the steps in [Connect machines from Azure portal](onboard-portal.md).<br> From the Azure portal, you can generate a script and execute it on the machine to automate the install and configuration steps of the agent.|
220-
| At scale | Install and configure the agent for multiple machines following the [Connect machines using a Service Principal](onboard-service-principal.md).<br> This method creates a service principal to connect machines non-interactively.|
221-
| At scale | Install and configure the agent for multiple machines following the method [Connect hybrid machines to Azure from Automation Update Management](onboard-update-management-machines.md).<br> This method creates a service principal, and installs and configures the agent for multiple machines managed with Azure Automation Update Management to connect machines non-interactively. |
222-
| At scale | Install and configure the agent for multiple machines following the method [Using Windows PowerShell DSC](onboard-dsc.md).<br> This method uses a service principal to connect machines non-interactively with PowerShell DSC. |
216+
| Interactively | Manually install the agent on a single or small number of machines by [connecting machines using a deployment script](onboard-portal.md).<br> From the Azure portal, you can generate a script and execute it on the machine to automate the install and configuration steps of the agent.|
217+
| Interactively | [Connect machines from Windows Admin Center](onboard-windows-admin-center.md) |
218+
| Interactively or at scale | [Connect machines using PowerShell](onboard-powershell.md) |
219+
| Interactively or at scale | [Connect machines using Windows PowerShell Desired State Configuration (DSC)](onboard-dsc.md) |
220+
| At scale | [Connect machines using a service principal](onboard-service-principal.md) to install the agent at scale non-interactively.|
221+
| At scale | [Connect machines by running PowerShell scripts with Configuration Manager](onboard-configuration-manager-powershell.md)
222+
| At scale | [Connect machines with a Configuration Manager custom task sequence](onboard-configuration-manager-custom-task.md)
223+
| At scale | [Connect machines from Automation Update Management](onboard-update-management-machines.md) to create a service principal that installs and configures the agent for multiple machines managed with Azure Automation Update Management to connect machines non-interactively. |
224+
225+
226+
227+
228+
> [!IMPORTANT]
229+
> The Connected Machine agent cannot be installed on an Azure Windows virtual machine. If you attempt to, the installation detects this and rolls back.
223230
224231
## Connected Machine agent technical overview
225232

226233
### Windows agent installation details
227234

228235
The Connected Machine agent for Windows can be installed by using one of the following three methods:
229236

230-
* Double-click the file `AzureConnectedMachineAgent.msi`.
237+
* Running the file `AzureConnectedMachineAgent.msi`.
231238
* Manually by running the Windows Installer package `AzureConnectedMachineAgent.msi` from the Command shell.
232239
* From a PowerShell session using a scripted method.
233240

articles/azure-arc/servers/plan-at-scale-deployment.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to plan and deploy Azure Arc-enabled servers
33
description: Learn how to enable a large number of machines to Azure Arc-enabled servers to simplify configuration of essential security, management, and monitoring capabilities in Azure.
4-
ms.date: 08/27/2021
4+
ms.date: 02/22/2022
55
ms.topic: conceptual
66
---
77

@@ -70,7 +70,7 @@ Next, we add to the foundation laid in phase 1 by preparing for and deploying th
7070

7171
|Task |Detail |Duration |
7272
|-----|-------|---------|
73-
| Download the pre-defined installation script | Review and customize the pre-defined installation script for at-scale deployment of the Connected Machine agent to support your automated deployment requirements.<br><br> Sample at-scale onboarding resources:<br><br> <ul><li> [At-scale basic deployment script](onboard-service-principal.md)</ul></li> <ul><li>[At-scale onboarding VMware vSphere Windows Server VMs](https://github.com/microsoft/azure_arc/blob/main/docs/azure_arc_jumpstart/azure_arc_servers/scaled_deployment/vmware_scaled_powercli_win/_index.md)</ul></li> <ul><li>[At-scale onboarding VMware vSphere Linux VMs](https://github.com/microsoft/azure_arc/blob/main/docs/azure_arc_jumpstart/azure_arc_servers/scaled_deployment/vmware_scaled_powercli_linux/_index.md)</ul></li> <ul><li>[At-scale onboarding AWS EC2 instances using Ansible](https://github.com/microsoft/azure_arc/blob/main/docs/azure_arc_jumpstart/azure_arc_servers/scaled_deployment/aws_scaled_ansible/_index.md)</ul></li> <ul><li>[At-scale deployment using PowerShell remoting](./onboard-powershell.md) (Windows only)</ul></li>| One or more days depending on requirements, organizational processes (for example, Change and Release Management), and automation method used. |
73+
| Download the pre-defined installation script | Review and customize the pre-defined installation script for at-scale deployment of the Connected Machine agent to support your automated deployment requirements.<br><br> Sample at-scale onboarding resources:<br><br> <ul><li> [At-scale basic deployment script](onboard-service-principal.md)</ul></li> <ul><li>[At-scale onboarding VMware vSphere Windows Server VMs](https://github.com/microsoft/azure_arc/blob/main/docs/azure_arc_jumpstart/azure_arc_servers/scaled_deployment/vmware_scaled_powercli_win/_index.md)</ul></li> <ul><li>[At-scale onboarding VMware vSphere Linux VMs](https://github.com/microsoft/azure_arc/blob/main/docs/azure_arc_jumpstart/azure_arc_servers/scaled_deployment/vmware_scaled_powercli_linux/_index.md)</ul></li> <ul><li>[At-scale onboarding AWS EC2 instances using Ansible](https://github.com/microsoft/azure_arc/blob/main/docs/azure_arc_jumpstart/azure_arc_servers/scaled_deployment/aws_scaled_ansible/_index.md)</ul></li> | One or more days depending on requirements, organizational processes (for example, Change and Release Management), and automation method used. |
7474
| [Create service principal](onboard-service-principal.md#create-a-service-principal-for-onboarding-at-scale) |Create a service principal to connect machines non-interactively using Azure PowerShell or from the portal.| One hour |
7575
| Deploy the Connected Machine agent to your target servers and machines |Use your automation tool to deploy the scripts to your servers and connect them to Azure.| One or more days depending on your release plan and if following a phased rollout. |
7676

articles/azure-arc/servers/toc.yml

Lines changed: 20 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -43,22 +43,26 @@
4343
href: agent-overview.md
4444
- name: Plan for deployment
4545
href: plan-at-scale-deployment.md
46-
- name: Connect machines using a deployment script
47-
href: onboard-portal.md
48-
- name: Connect machines at scale using a service principal
49-
href: onboard-service-principal.md
50-
- name: Connect machines at scale using Configuration Manager script
51-
href: onboard-configuration-manager-powershell.md
52-
- name: Connect machines at scale using Configuration Manager custom task sequence
53-
href: onboard-configuration-manager-custom-task.md
54-
- name: Connect machines from Automation Update Management
55-
href: onboard-update-management-machines.md
56-
- name: Connect machines to Azure Arc with PowerShell DSC
57-
href: onboard-dsc.md
58-
- name: Connect machines from Windows Admin Center
59-
href: onboard-windows-admin-center.md
60-
- name: Connect machines to Azure Arc with PowerShell
61-
href: onboard-powershell.md
46+
- name: Connect machines interactively
47+
items:
48+
- name: Connect machines using a deployment script
49+
href: onboard-portal.md
50+
- name: Connect machines from Windows Admin Center
51+
href: onboard-windows-admin-center.md
52+
- name: Connect machines to Azure Arc with PowerShell
53+
href: onboard-powershell.md
54+
- name: Connect machines to Azure Arc with PowerShell DSC
55+
href: onboard-dsc.md
56+
- name: Connect machines at scale
57+
items:
58+
- name: Connect machines using a service principal
59+
href: onboard-service-principal.md
60+
- name: Connect machines using Configuration Manager script
61+
href: onboard-configuration-manager-powershell.md
62+
- name: Connect machines using Configuration Manager custom task sequence
63+
href: onboard-configuration-manager-custom-task.md
64+
- name: Connect machines from Automation Update Management
65+
href: onboard-update-management-machines.md
6266
- name: Migrate
6367
items:
6468
- name: Migrate machine to Azure

0 commit comments

Comments
 (0)