Merge pull request #111149 from MGoedtel/task1679967

update Agent Management related to azcmagent

Author: itechedit

.openpublishing.redirection.json

@@ -1697,6 +1697,11 @@
       "redirect_url": "/azure/architecture/reference-architectures/enterprise-integration/queues-events",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/azure-arc/servers/azcmagent-reference.md",
+      "redirect_url": "/azure/azure-arc/servers/manage-agent",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/cognitive-services/bing-web-search/computer-vision-web-search-tutorial.md",
       "redirect_url": "/azure/cognitive-services/bing-web-search/index",

articles/azure-arc/servers/azcmagent-reference.md

@@ -6,7 +6,7 @@ ms.service: azure-arc
 ms.subservice: azure-arc-servers
 author: mgoedtel
 ms.author: magoedte
-ms.date: 04/01/2020
+ms.date: 04/14/2020
 ms.topic: conceptual
 ---
 
@@ -108,6 +108,78 @@ Actions of the [yum](https://access.redhat.com/articles/yum-cheat-sheet) command
 
 Actions of the [zypper](https://en.opensuse.org/Portal:Zypper) command, such as installation and removal of packages, are logged in the `/var/log/zypper.log` log file. 
 
+## About the Azcmagent tool
+
+The Azcmagent tool (Azcmagent.exe) is used to configure the Azure Arc for servers (preview) Connected Machine agent during installation, or modify the initial configuration of the agent after installation. Azcmagent.exe provides command-line parameters to customize the agent and view its status:
+
+* **Connect** - To connect the machine to Azure Arc
+
+* **Disconnect** - To disconnect the machine from Azure Arc
+
+* **Reconnect** - To reconnect a disconnected machine to Azure Arc
+
+* **Show** - View agent status and its configuration properties (Resource Group name, Subscription ID, version, etc.), which can help when troubleshooting an issue with the agent.
+
+* **-h or --help** - Shows available command-line parameters
+
+    For example, to see detailed help for the **Reconnect** parameter, type `azcmagent reconnect -h`. 
+
+* **-v or --verbose** - Enable verbose logging
+
+You can perform a **Connect**, **Disconnect**, and **Reconnect** manually while logged on interactively, or automate using the same service principal you used to onboard multiple agents or with a Microsoft identity platform [access token](../../active-directory/develop/access-tokens.md). If you did not use a service principal to register the machine with Azure Arc for servers (preview), see the following [article](onboard-service-principal.md#create-a-service-principal-for-onboarding-at-scale) to create a service principal.
+
+### Connect
+
+This parameter specifies a resource in Azure Resource Manager representing the machine is created in Azure. The resource is in the subscription and resource group specified, and data about the machine is stored in the Azure region specified by the `--location` setting. The default resource name is the hostname of this machine if not specified.
+
+A certificate corresponding to the system-assigned identity of the machine is then downloaded and stored locally. Once this step is completed, the Azure Connected Machine Metadata Service and Guest Configuration Agent begin synchronizing with Azure Arc for servers (preview).
+
+To connect using a service principal, run the following command:
+
+`azcmagent connect --service-principal-id <serviceprincipalAppID> --service-principal-secret <serviceprincipalPassword> --tenant-id <tenantID> --subscription-id <subscriptionID> --resource-group <ResourceGroupName> --location <resourceLocation>`
+
+To connect using an access token, run the following command:
+
+`azcmagent connect --access-token <> --subscription-id <subscriptionID> --resource-group <ResourceGroupName> --location <resourceLocation>`
+
+To connect with your elevated logged-on credentials (interactive), run the following command:
+
+`azcmagent connect --tenant-id <TenantID> --subscription-id <subscriptionID> --resource-group <ResourceGroupName> --location <resourceLocation>`
+
+### Disconnect
+
+This parameter specifies a resource in Azure Resource Manager representing the machine is deleted in Azure. It does not delete the agent from the machine, this must be done as a separate step. After the machine is disconnected, if you want to re-register it with Azure Arc for servers (preview), use `azcmagent connect` so a new resource is created for it in Azure.
+
+To disconnect using a service principal, run the following command:
+
+`azcmagent disconnect --service-principal-id <serviceprincipalAppID> --service-principal-secret <serviceprincipalPassword> --tenant-id <tenantID>`
+
+To disconnect using an access token, run the following command:
+
+`azcmagent disconnect --access-token <accessToken>`
+
+To disconnect with your elevated logged-on credentials (interactive), run the following command:
+
+`azcmagent disconnect --tenant-id <tenantID>`
+
+### Reconnect
+
+This parameter reconnects the already registered or connected machine with Azure Arc for servers (preview). This may be necessary if the machine has been turned off, at least 45 days, for its certificate to expire. This parameter uses the authentication options provided to retrieve new credentials corresponding to the Azure Resource Manager resource representing this machine.
+
+This command requires higher privileges than the [Azure Connected Machine Onboarding](overview.md#required-permissions) role.
+
+To reconnect using a service principal, run the following command:
+
+`azcmagent reconnect --service-principal-id <serviceprincipalAppID> --service-principal-secret <serviceprincipalPassword> --tenant-id <tenantID>`
+
+To reconnect using an access token, run the following command:
+
+`azcmagent reconnect --access-token <accessToken>`
+
+To reconnect with your elevated logged-on credentials (interactive), run the following command:
+
+`azcmagent reconnect --tenant-id <tenantID>`
+
 ## Remove the agent
 
 Perform one of the following methods to uninstall the Windows or Linux Connected Machine agent from the machine. Removing the agent does not unregister the machine with Arc for servers (preview), this is a separate process you perform when you no longer need to manage the machine in Azure.
@@ -179,7 +251,7 @@ To uninstall the Linux agent, the command to use depends on the Linux operating
 
 ## Unregister machine
 
-If you are planning to stop managing the machine with supporting services in Azure, perform the following steps to unregister the machine with Arc for servers (preview). You can perform these step either before or after you have removed the Connected Machine agent from the machine.
+If you are planning to stop managing the machine with supporting services in Azure, perform the following steps to unregister the machine with Arc for servers (preview). You can perform these steps either before or after you have removed the Connected Machine agent from the machine.
 
 1. Open Azure Arc for servers (preview) by going to the [Azure portal](https://aka.ms/hybridmachineportal).
 

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

@@ -138,7 +138,7 @@ You can download the Azure Connected Machine agent package for Windows and L
 >[!NOTE]
 >During this preview, only one package has been released, which is suitable for Ubuntu 16.04 or 18.04.
 
-The Azure Connected Machine agent for Windows and Linux can be upgraded to the latest release manually or automatically depending on your requirements. For more information, see [here](manage-agent.md)
+The Azure Connected Machine agent for Windows and Linux can be upgraded to the latest release manually or automatically depending on your requirements. For more information, see [here](manage-agent.md).
 
 ### Agent status
 

articles/azure-arc/servers/overview.md

@@ -17,8 +17,4 @@
   - name: Manage
     items:
     - name: Manage agent
-      href: ./servers/manage-agent.md
-- name: Reference
-  items:
-  - name: Azure Connected Machine Agent CLI interface
-    href: ./servers/azcmagent-reference.md
+      href: ./servers/manage-agent.md