Merge pull request #314040 from Xelu86/azmondepps

v-dirichards · web-flow · commit 3083c462bc9a · 2026-04-01T10:54:17.000-05:00
[Update] Deploy Azure Monitor for SAP solutions by using Azure PowerShell
diff --git a/articles/sap/monitor/quickstart-powershell.md b/articles/sap/monitor/quickstart-powershell.md
@@ -1,34 +1,35 @@
 ---
 title: Deploy Azure Monitor for SAP solutions by using Azure PowerShell
-description: Learn how to use Azure PowerShell to deploy Azure Monitor for SAP solutions.
+description: Learn how to deploy Azure Monitor for SAP solutions and create provider instances by using Azure PowerShell.
 author: sameeksha91
 ms.author: sakhare
-ms.topic: quickstart
+ms.topic: how-to
 ms.service: sap-on-azure
 ms.subservice: sap-monitor
-ms.date: 08/22/2024
+ms.date: 03/30/2026
 ms.devlang: azurepowershell
 ms.custom: devx-track-azurepowershell, mode-api
-# Customer intent: As a developer, I want to deploy Azure Monitor for SAP solutions by using PowerShell so that I can create resources by using PowerShell.
+#Customer intent: As a system administrator, I want to deploy Azure Monitor for SAP solutions by using Azure PowerShell so that I can automate resource creation and configure monitoring providers.
 ---
 
-# Quickstart: Deploy Azure Monitor for SAP solutions by using PowerShell
+# Deploy Azure Monitor for SAP solutions by using Azure PowerShell
 
-In this quickstart, get started with Azure Monitor for SAP solutions by using the [Az.Workloads](/powershell/module/az.workloads) PowerShell module to create Azure Monitor for SAP solutions resources. You create a resource group, set up monitoring, and create a provider instance.
+Azure Monitor for SAP solutions is an Azure-native monitoring product for SAP landscapes that run on Azure. If your critical SAP applications run on Azure, use it to monitor their availability, performance, and operation.
+
+In this quickstart, you use Azure PowerShell to deploy an Azure Monitor for SAP solutions resource and connect it to your SAP system through a provider instance.
 
 ## Prerequisites
 
 - If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) before you begin.
-- If you choose to use PowerShell locally, this article requires that you install the Az PowerShell module. Connect to your Azure account by using the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) cmdlet. For more information about installing the Az PowerShell module, see [Install Azure PowerShell](/powershell/azure/install-az-ps). Alternately, you can use [Azure Cloud Shell](../../cloud-shell/overview.md).
+- To use Azure PowerShell locally, install the Az PowerShell module and connect to your Azure account by using the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) cmdlet. For more information about installing the Az PowerShell module, see [Install Azure PowerShell](/powershell/azure/install-az-ps). Alternatively, you can use [Azure Cloud Shell](../../cloud-shell/overview.md).
 
   Install the **Az.Workloads** PowerShell module by running this command:
 
   ```azurepowershell-interactive
   Install-Module -Name Az.Workloads
   ```
 
-- If you have multiple Azure subscriptions, select the subscription in which the resources should be billed by using the
-[Set-AzContext](/powershell/module/az.accounts/set-azcontext) cmdlet:
+- If you have multiple Azure subscriptions, use the [Set-AzContext](/powershell/module/az.accounts/set-azcontext) cmdlet to select the subscription that you want to use for billing:
 
   ```azurepowershell-interactive
   Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
@@ -37,76 +38,83 @@ In this quickstart, get started with Azure Monitor for SAP solutions by using th
 - Create or choose a virtual network for Azure Monitor for SAP solutions that has access to the source SAP system's virtual network.
 - Create a subnet with an address range of IPv4/25 or larger in the virtual network associated with Azure Monitor for SAP solutions, with subnet delegation assigned to **Microsoft.Web/serverFarms**.
 
-   > [!div class="mx-imgBorder"]
-   > ![Screenshot that shows subnet creation for Azure Monitor for SAP solutions.](./media/quickstart-powershell/subnet-creation.png)
+  > [!div class="mx-imgBorder"]
+  > ![Screenshot that shows subnet creation for Azure Monitor for SAP solutions.](./media/quickstart-powershell/subnet-creation.png)
 
 ## Create a resource group
 
-Create an [Azure resource group](../../azure-resource-manager/management/overview.md) by using the [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) cmdlet. A resource group is a logical container in which Azure resources are deployed and managed as a group.
+Create an [Azure resource group](../../azure-resource-manager/management/overview.md) by using the [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) cmdlet. A resource group is a logical container in which you deploy and manage Azure resources as a group.
 
-The following example creates a resource group with the specified name and in the specified location:
+Run the following command to create a resource group with the specified name and in the specified location:
 
 ```azurepowershell-interactive
 New-AzResourceGroup -Name Contoso-AMS-RG -Location <myResourceLocation>
 ```
 
 ## Create an SAP monitor
 
-To create an SAP monitor, use the [New-AzWorkloadsMonitor](/powershell/module/az.workloads/new-azworkloadsmonitor) cmdlet. The following example creates an SAP monitor for the specified subscription, resource group, and resource name:
+To create an SAP monitor, use the [New-AzWorkloadsMonitor](/powershell/module/az.workloads/new-azworkloadsmonitor) cmdlet.
 
-```azurepowershell-interactive
-$monitor_name = 'Contoso-AMS-Monitor'
-$rg_name = 'Contoso-AMS-RG'
-$subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
-$location = 'eastus'
-$managed_rg_name = 'MRG_Contoso-AMS-Monitor'
-$subnet_id = '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ams-vnet-rg/providers/Microsoft.Network/virtualNetworks/ams-vnet-eus/subnets/Contoso-AMS-Monitor'
-$route_all = 'RouteAll'
+1. Run the following command to create an SAP monitor for the specified subscription, resource group, and resource name:
 
-New-AzWorkloadsMonitor -Name $monitor_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -Location $location -AppLocation $location -ManagedResourceGroupName $managed_rg_name -MonitorSubnet $subnet_id -RoutingPreference $route_all
-```
+   ```azurepowershell-interactive
+   $monitor_name = 'Contoso-AMS-Monitor'
+   $rg_name = 'Contoso-AMS-RG'
+   $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
+   $location = 'eastus'
+   $managed_rg_name = 'MRG_Contoso-AMS-Monitor'
+   $subnet_id = '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ams-vnet-rg/providers/Microsoft.Network/virtualNetworks/ams-vnet-eus/subnets/Contoso-AMS-Monitor'
+   $route_all = 'RouteAll'
 
-To get the properties of an SAP monitor, use the [Get-AzWorkloadsMonitor](/powershell/module/az.workloads/get-azworkloadsmonitor) cmdlet. The following example gets the properties of an SAP monitor for the specified subscription, resource group, and resource name:
+   New-AzWorkloadsMonitor -Name $monitor_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -Location $location -AppLocation $location -ManagedResourceGroupName $managed_rg_name -MonitorSubnet $subnet_id -RoutingPreference $route_all
+   ```
 
-```azurepowershell-interactive
-Get-AzWorkloadsMonitor -ResourceGroupName Contoso-AMS-RG -Name Contoso-AMS-Monitor
-```
+1. To get the properties of the SAP monitor, run the following command:
+
+   ```azurepowershell-interactive
+   Get-AzWorkloadsMonitor -ResourceGroupName Contoso-AMS-RG -Name Contoso-AMS-Monitor
+   ```
 
 ## Create a provider
 
-### Create an SAP NetWeaver provider
+### [SAP NetWeaver](#tab/sap-netweaver)
 
-To create an SAP NetWeaver provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet. The following example creates a NetWeaver provider for the specified subscription, resource group, and resource name:
+To create an SAP NetWeaver provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet.
 
-```azurepowershell-interactive
-Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
-```
+1. Run the following command to set the subscription context:
 
-In the following code, `hostname` is the host name or IP address for SAP Web Dispatcher or the application server. `SapHostFileEntry` is the IP address, fully qualified domain name, or host name of every instance listed in [GetSystemInstanceList](./provider-netweaver.md#adding-netweaver-provider) point 6 (xi).
+   ```azurepowershell-interactive
+   Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
+   ```
 
-```azurepowershell-interactive
-$subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
-$rg_name = 'Contoso-AMS-RG'
-$monitor_name = 'Contoso-AMS-Monitor'
-$provider_name = 'Contoso-AMS-Monitor-NW'
+1. Run the following command to create the NetWeaver provider instance.
 
-$SapClientId = '000'
-$SapHostFileEntry = '["10.0.0.0 x01scscl1.ams.azure.com x01scscl1,10.0.0.0 x01erscl1.ams.azure.com x01erscl1,10.0.0.1 x01appvm1.ams.azure.com x01appvm1,10.0.0.2 x01appvm2.ams.azure.com x01appvm2"]'
-$hostname = 'x01appvm0'
-$instance_number = '00'
-$password = 'Password@123'
-$sapportNumber = '8000'
-$sap_sid = 'X01'
-$sap_username = 'AMS_NW'
-$providerSetting = New-AzWorkloadsProviderSapNetWeaverInstanceObject -SapClientId $SapClientId -SapHostFileEntry $SapHostFileEntry -SapHostname $hostname -SapInstanceNr $instance_number -SapPassword $password -SapPortNumber $sapportNumber -SapSid $sap_sid -SapUsername $sap_username -SslPreference Disabled
+   In this code, `hostname` is the host name or IP address for SAP Web Dispatcher or the application server. `SapHostFileEntry` is the IP address, fully qualified domain name, or host name of every instance listed in [GetSystemInstanceList](./provider-netweaver.md#adding-netweaver-provider) point 6 (xi).
 
-New-AzWorkloadsProviderInstance -MonitorName $monitor_name -Name $provider_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -ProviderSetting $providerSetting
+   ```azurepowershell-interactive
+   $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
+   $rg_name = 'Contoso-AMS-RG'
+   $monitor_name = 'Contoso-AMS-Monitor'
+   $provider_name = 'Contoso-AMS-Monitor-NW'
 
-```
+   $SapClientId = '000'
+   $SapHostFileEntry = '["10.0.0.0 x01scscl1.ams.azure.com x01scscl1,10.0.0.0 x01erscl1.ams.azure.com x01erscl1,10.0.0.1 x01appvm1.ams.azure.com x01appvm1,10.0.0.2 x01appvm2.ams.azure.com x01appvm2"]'
+   $hostname = 'x01appvm0'
+   $instance_number = '00'
+   $password = 'Password@123'
+   $sapportNumber = '8000'
+   $sap_sid = 'X01'
+   $sap_username = 'AMS_NW'
+   $providerSetting = New-AzWorkloadsProviderSapNetWeaverInstanceObject -SapClientId $SapClientId -SapHostFileEntry $SapHostFileEntry -SapHostname $hostname -SapInstanceNr $instance_number -SapPassword $password -SapPortNumber $sapportNumber -SapSid $sap_sid -SapUsername $sap_username -SslPreference Disabled
+
+   New-AzWorkloadsProviderInstance -MonitorName $monitor_name -Name $provider_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -ProviderSetting $providerSetting
+   ```
 
-### Create an SAP HANA provider
+### [SAP HANA](#tab/sap-hana)
 
-To create an SAP HANA provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet. The following example creates a HANA provider for the specified subscription, resource group, and resource name:
+To create an SAP HANA provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet.
+
+Run the following command to create a HANA provider for the specified subscription, resource group, and resource name:
 
 ```azurepowershell-interactive
 $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
@@ -125,9 +133,11 @@ $providerSetting = New-AzWorkloadsProviderHanaDbInstanceObject -Name $dbName -Pa
 New-AzWorkloadsProviderInstance -MonitorName $monitor_name -Name $provider_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -ProviderSetting $providerSetting
 ```
 
-### Create an operating system provider
+### [Operating system](#tab/os)
+
+To create an operating system provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet.
 
-To create an operating system provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet. The following example creates an operating system provider for the specified subscription, resource group, and resource name:
+Run the following command to create an operating system provider for the specified subscription, resource group, and resource name:
 
 ```azurepowershell-interactive
 $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
@@ -142,9 +152,11 @@ $providerSetting = New-AzWorkloadsProviderPrometheusOSInstanceObject -Prometheus
 New-AzWorkloadsProviderInstance -MonitorName $monitor_name -Name $provider_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -ProviderSetting $providerSetting
 ```
 
-### Create a high-availability cluster provider
+### [HA cluster](#tab/ha-cluster)
 
-To create a high-availability cluster provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet. The following example creates a high-availability cluster provider for the specified subscription, resource group, and resource name:
+To create a high-availability cluster provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet.
+
+Run the following command to create a high-availability cluster provider for the specified subscription, resource group, and resource name:
 
 ```azurepowershell-interactive
 $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
@@ -161,9 +173,11 @@ $providerSetting = New-AzWorkloadsProviderPrometheusHaClusterInstanceObject -Clu
 New-AzWorkloadsProviderInstance -MonitorName $monitor_name -Name $provider_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -ProviderSetting $providerSetting
 ```
 
-### Create a Microsoft SQL Server provider
+### [Microsoft SQL Server](#tab/sql-server)
+
+To create a Microsoft SQL Server provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet.
 
-To create a Microsoft SQL Server provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet. The following example creates a SQL Server provider for the specified subscription, resource group, and resource name:
+Run the following command to create a SQL Server provider for the specified subscription, resource group, and resource name:
 
 ```azurepowershell-interactive
 $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
@@ -181,9 +195,11 @@ $providerSetting = New-AzWorkloadsProviderSqlServerInstanceObject -Password $pas
 New-AzWorkloadsProviderInstance -MonitorName $monitor_name -Name $provider_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -ProviderSetting $providerSetting
 ```
 
-### Create an IBM Db2 provider
+### [IBM Db2](#tab/ibm-db2)
 
-To create an IBM Db2 provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet. The following example creates an IBM Db2 provider for the specified subscription, resource group, and resource name:
+To create an IBM Db2 provider, use the [New-AzWorkloadsProviderInstance](/powershell/module/az.workloads/new-azworkloadsproviderinstance) cmdlet.
+
+Run the following command to create an IBM Db2 provider for the specified subscription, resource group, and resource name:
 
 ```azurepowershell-interactive
 $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
@@ -203,27 +219,23 @@ $providerSetting = New-AzWorkloadsProviderDB2InstanceObject -Name $dbName -Passw
 New-AzWorkloadsProviderInstance -MonitorName $monitor_name -Name $provider_name -ResourceGroupName $rg_name -SubscriptionId $subscription_id -ProviderSetting $providerSetting
 ```
 
-### Get properties of a provider instance
+---
 
-To get the properties of a provider instance, use the [Get-AzWorkloadsProviderInstance](/powershell/module/az.workloads/get-azworkloadsproviderinstance) cmdlet. The following example gets the properties of:
+### Get properties of a provider instance
 
-- A provider instance for the specified subscription.
-- The resource group.
-- The SAP monitor name.
-- The resource name.
+To get the properties of a provider instance, use the [Get-AzWorkloadsProviderInstance](/powershell/module/az.workloads/get-azworkloadsproviderinstance) cmdlet. The following example gets provider instance properties for the specified resource group and SAP monitor name:
 
 ```azurepowershell-interactive
 Get-AzWorkloadsProviderInstance -ResourceGroupName Contoso-AMS-RG -SapMonitorName Contoso-AMS-Monitor
 ```
 
 ## Clean up resources
 
-If you don't need the resources that you created in this article, you can delete them by using the following examples.
+If you don't need the resources that you created in this article, you can delete them by running the following commands.
 
 ### Delete the provider instance
 
-To remove a provider instance, use the
-[Remove-AzWorkloadsProviderInstance](/powershell/module/az.workloads/remove-azworkloadsproviderinstance) cmdlet. The following example deletes an IBM DB2 provider instance for the specified subscription, resource group, SAP monitor name, and resource name:
+To remove a provider instance, use the [Remove-AzWorkloadsProviderInstance](/powershell/module/az.workloads/remove-azworkloadsproviderinstance) cmdlet. The following example deletes an IBM Db2 provider instance for the specified subscription, resource group, SAP monitor name, and resource name:
 
 ```azurepowershell-interactive
 $subscription_id = 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'
@@ -248,18 +260,17 @@ Remove-AzWorkloadsMonitor -Name $monitor_name -ResourceGroupName $rg_name -Subsc
 
 ### Delete the resource group
 
-The following example deletes the specified resource group and all the resources in it.
+The following example deletes the specified resource group and all its resources.
 
 > [!CAUTION]
-> If resources outside the scope of this article exist in the specified resource group, they'll also be deleted.
+> If resources outside the scope of this article exist in the specified resource group, they're also deleted.
 
 ```azurepowershell-interactive
 Remove-AzResourceGroup -Name Contoso-AMS-RG
 ```
 
-## Next steps
-
-Learn more about Azure Monitor for SAP solutions.
+## Related content
 
-> [!div class="nextstepaction"]
-> [Monitor SAP on Azure](about-azure-monitor-sap-solutions.md)
+- [What is Azure Monitor for SAP solutions?](about-azure-monitor-sap-solutions.md)
+- [Quickstart: Deploy Azure Monitor for SAP solutions by using the Azure portal](quickstart-portal.md)
+- [Azure Monitor for SAP solutions provider types](providers.md)
