You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: azure-stack/user/azure-stack-powershell-configure-user.md
+21-24Lines changed: 21 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,10 @@
2
2
title: Connect to Azure Stack Hub with PowerShell as a user
3
3
description: Learn how to connect to Azure Stack Hub with PowerShell to use the interactive prompt or write scripts.
4
4
author: sethmanheim
5
-
6
5
ms.topic: article
7
6
ms.custom:
8
7
- devx-track-azurepowershell
9
-
ms.date: 11/22/2020
8
+
ms.date: 03/06/2025
10
9
ms.author: sethm
11
10
ms.reviewer: thoroet
12
11
ms.lastreviewed: 11/22/2020
@@ -20,25 +19,23 @@ ms.lastreviewed: 11/22/2020
20
19
21
20
You can connect to Azure Stack Hub with PowerShell to manage Azure Stack Hub resources. For example, you can use PowerShell to subscribe to offers, create virtual machines (VMs), and deploy Azure Resource Manager templates.
22
21
23
-
To get setup:
24
-
- Make sure you have the requirements.
25
-
- Connect with Microsoft Entra ID or Active Directory Federation Services (AD FS).
26
-
- Register resource providers.
27
-
- Test your connectivity.
22
+
Before you begin, make sure you have the following prerequisites:
23
+
24
+
- Connect with Microsoft Entra ID or Active Directory Federation Services (AD FS).
25
+
- Register resource providers.
26
+
- Test your connectivity.
28
27
29
28
## Prerequisites to connecting with PowerShell
30
29
31
-
Configure these prerequisites from the [development kit](../asdk/asdk-connect.md#connect-to-azure-stack-using-rdp), or from a Windows-based external client if you're [connected through VPN](../asdk/asdk-connect.md#connect-to-azure-stack-using-vpn):
30
+
Configure these prerequisites from a Windows-based external client if you're connected through VPN.
- Download the [tools required to work with Azure Stack Hub](../operator/azure-stack-powershell-download.md).
35
34
36
35
Make sure you replace the following script variables with values from your Azure Stack Hub configuration:
37
36
38
-
-**Microsoft Entra tenant name**
39
-
The name of your Microsoft Entra tenant used to manage Azure Stack Hub. For example, yourdirectory.onmicrosoft.com.
40
-
-**Azure Resource Manager endpoint**
41
-
For Azure Stack Development kit, this value is set to `https://management.local.azurestack.external`. To get this value for Azure Stack Hub integrated systems, contact your service provider.
37
+
-**Microsoft Entra tenant name**: the name of your Microsoft Entra tenant used to manage Azure Stack Hub. For example, `yourdirectory.onmicrosoft.com`.
38
+
-**Azure Resource Manager endpoint**: to get this value for Azure Stack Hub integrated systems, contact your service provider.
@@ -97,7 +95,6 @@ Make sure you replace the following script variables with values from your Azure
97
95
98
96
---
99
97
100
-
101
98
## Register resource providers
102
99
103
100
Resource providers aren't automatically registered for new user subscriptions that don't have any resources deployed through the portal. You can explicitly register a resource provider by running the following script:
@@ -111,8 +108,9 @@ foreach($s in (Get-AzSubscription)) {
When you've got everything setup, test connectivity by using PowerShell to create resources in Azure Stack Hub. As a test, create a resource group for an application and add a VM. Run the following command to create a resource group named "MyResourceGroup":
128
+
When you have everything set up, test connectivity by using PowerShell to create resources in Azure Stack Hub. As a test, create a resource group for an application and add a VM. Run the following command to create a resource group named `MyResourceGroup`:
Copy file name to clipboardExpand all lines: azure-stack/user/azure-stack-quick-create-vm-linux-cli.md
+12-11Lines changed: 12 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,9 +2,8 @@
2
2
title: Create Linux VM with Azure CLI in Azure Stack Hub
3
3
description: Create a Linux virtual machine by using the Azure CLI in Azure Stack Hub.
4
4
author: sethmanheim
5
-
6
5
ms.topic: quickstart
7
-
ms.date: 03/12/2024
6
+
ms.date: 03/06/2025
8
7
ms.author: sethm
9
8
10
9
# Intent: As an Azure Stack user, I want to create a Linux server virtual machine using Azure CLI.
@@ -23,30 +22,32 @@ You can create an Ubuntu Server 20.04 LTS virtual machine (VM) by using the Azur
23
22
24
23
## Prerequisites
25
24
25
+
Before you begin, make sure you have the following prerequisites:
26
+
26
27
* A Linux image in the Azure Stack Hub Marketplace
27
28
28
29
The Azure Stack Hub Marketplace doesn't contain a Linux image by default. Have the Azure Stack Hub operator provide the Ubuntu Server 20.04 LTS image you need. The operator can use the instructions in [Download Marketplace items from Azure to Azure Stack Hub](../operator/azure-stack-download-azure-marketplace-item.md).
29
30
30
-
* Azure Stack Hub requires a specific version of the Azure CLI to create and manage its resources. If you don't have the Azure CLI configured for Azure Stack Hub, sign in to the [Azure Stack Development Kit](../asdk/asdk-connect.md#connect-to-azure-stack-using-rdp) (or a Windows-based external client if you're [connected through VPN](../asdk/asdk-connect.md#connect-to-azure-stack-using-vpn)), and follow the instructions for [installing and configuring the Azure CLI](azure-stack-version-profiles-azurecli2.md).
31
+
* Azure Stack Hub requires a specific version of the Azure CLI to create and manage its resources. If you don't have the Azure CLI configured for Azure Stack Hub, sign in to a Windows-based external client if you're connected through VPN, and follow the instructions for [installing and configuring the Azure CLI](azure-stack-version-profiles-azurecli2.md).
31
32
32
-
* A public Secure Shell (SSH) key with the name *id_rsa.pub* saved in the *.ssh* directory of your Windows user profile. For detailed information about creating SSH keys, see [Use an SSH key pair with Azure Stack Hub](azure-stack-dev-start-howto-ssh-public-key.md).
33
+
* A public Secure Shell (SSH) key with the name `id_rsa.pub` saved in the **.ssh** directory of your Windows user profile. For more information about creating SSH keys, see [Use an SSH key pair with Azure Stack Hub](azure-stack-dev-start-howto-ssh-public-key.md).
33
34
34
35
## Create a resource group
35
36
36
-
A resource group is a logical container where you can deploy and manage Azure Stack Hub resources. From your development kit or the Azure Stack Hub integrated system, run the [az group create](/cli/azure/group#az-group-create) command to create a resource group.
37
+
A resource group is a logical container where you can deploy and manage Azure Stack Hub resources. From your Azure Stack Hub integrated system, run the [az group create](/cli/azure/group#az-group-create) command to create a resource group.
37
38
38
39
> [!NOTE]
39
-
> We've assigned values for all variables in the following code examples. However, you can assign your own values.
40
+
> We assigned values for all variables in the following code examples. However, you can assign your own values.
40
41
41
-
The following example creates a resource group named myResourceGroup in the local location:
42
+
The following example creates a resource group named myResourceGroup in the local location:
42
43
43
44
```azurecli
44
45
az group create --name myResourceGroup --location local
45
46
```
46
47
47
48
## Create a virtual machine
48
49
49
-
Create a virtual machine by using the [az vm create](/cli/azure/vm#az-vm-create) command. The following example creates a VM named myVM. The example uses *Demouser* as the admin username and *Demouser@123* as the admin password. Change these values to something that's appropriate for your environment.
50
+
Create a virtual machine by using the [az vm create](/cli/azure/vm#az-vm-create) command. The following example creates a VM named myVM. The example uses `Demouser` as the admin username and `Demouser@123` as the admin password. Change these values to something that's appropriate for your environment.
50
51
51
52
```azurecli
52
53
az vm create \
@@ -58,19 +59,19 @@ az vm create \
58
59
--location local
59
60
```
60
61
61
-
The public IP address is returned in the **PublicIpAddress** parameter. Note the address for later use with the virtual machine.
62
+
The public IP address is returned in the `PublicIpAddress` parameter. Note the address for later use with the virtual machine.
62
63
63
64
## Open port 80 for web traffic
64
65
65
-
Because this virtual machine is going to run the IIS web server, you need to open port 80 to internet traffic. To open the port, use the [az vm open-port](/cli/azure/vm) command:
66
+
Because this virtual machine runs the IIS web server, you must open port 80 to internet traffic. To open the port, use the [az vm open-port](/cli/azure/vm) command:
66
67
67
68
```azurecli
68
69
az vm open-port --port 80 --resource-group myResourceGroup --name myVM
69
70
```
70
71
71
72
## Use SSH to connect to the virtual machine
72
73
73
-
From a client computer with SSH installed, connect to the virtual machine. If you're working on a Windows client, use [PuTTY](https://www.putty.org/) to create the connection. To connect to the virtual machine, use the following command:
74
+
From a client computer with SSH installed, connect to the virtual machine. If you work on a Windows client, use [PuTTY](https://www.putty.org/) to create the connection. To connect to the virtual machine, use the following command:
Copy file name to clipboardExpand all lines: azure-stack/user/azure-stack-storage-connect-se.md
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Connect Storage Explorer to Azure Stack Hub subscription or storage accou
3
3
description: Learn how to connect Storage Explorer to an Azure Stack Hub subscription.
4
4
author: sethmanheim
5
5
ms.topic: conceptual
6
-
ms.date: 02/20/2025
6
+
ms.date: 03/06/2025
7
7
ms.author: sethm
8
8
ms.reviewer: xiaofmao
9
9
ms.lastreviewed: 11/11/2019
@@ -24,9 +24,7 @@ After you connect to an Azure Stack Hub subscription or storage account, see the
24
24
25
25
## Prepare for connecting to Azure Stack Hub
26
26
27
-
You need direct access to Azure Stack Hub or a VPN connection for Storage Explorer to access the Azure Stack Hub subscription. To learn how to set up a VPN connection to Azure Stack Hub, see [Connect to Azure Stack Hub with VPN](../asdk/asdk-connect.md#connect-to-azure-stack-using-vpn).
28
-
29
-
For integrated systems that are disconnected, the recommendation is to use an internal enterprise Certificate Authority to export the root certificate in a Base-64 format and then import it into Azure Storage Explorer.
27
+
You need direct access to Azure Stack Hub or a VPN connection for Storage Explorer to access the Azure Stack Hub subscription. For integrated systems that are disconnected, the recommendation is to use an internal enterprise Certificate Authority to export the root certificate in a Base-64 format and then import it into Azure Storage Explorer.
30
28
31
29
> [!NOTE]
32
30
> Azure Storage Explorer relies on the Node.js networking stack to determine which default certificate signers to trust. [Learn more](/azure/storage/common/storage-explorer-network#ssl-certificates).
Copy file name to clipboardExpand all lines: azure-stack/user/azure-stack-validate-templates.md
+40-42Lines changed: 40 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,11 +2,9 @@
2
2
title: Use the template validation tool in Azure Stack Hub
3
3
description: Check templates for deployment to Azure Stack Hub with a template validation tool.
4
4
author: sethmanheim
5
-
6
5
ms.topic: article
7
-
ms.date: 10/27/2021
6
+
ms.date: 03/06/2025
8
7
ms.author: sethm
9
-
ms.reviewer: unknown
10
8
ms.lastreviewed: 10/27/2021
11
9
12
10
# Intent: As an Azure Stack user, I want to use the template validation tool so I can see if my templates are ready to deploy.
@@ -37,33 +35,33 @@ Before you use the template validator, run the **Az.CloudCapabilities** PowerShe
37
35
38
36
### [Az modules](#tab/az1)
39
37
40
-
1. Make sure you have connectivity to Azure Stack Hub. These steps can be done from the Azure Stack Development Kit (ASDK) host, or you can use a [VPN](../asdk/asdk-connect.md#connect-to-azure-stack-using-vpn) to connect from your workstation.
41
-
2. Import the **Az.CloudCapabilities** PowerShell module:
38
+
1. Make sure you have connectivity to Azure Stack Hub. These steps can be done from a VPN to connect from your workstation.
39
+
1. Import the **Az.CloudCapabilities** PowerShell module:
3. Use the **Get-CloudCapabilities** cmdlet to retrieve service versions and create a cloud capabilities JSON file. If you don't specify `-OutputPath`, the file **AzureCloudCapabilities.json** is created in the current directory. Use your actual Azure location:
45
+
1. Use the `Get-CloudCapabilities` cmdlet to retrieve service versions and create a cloud capabilities JSON file. If you don't specify `-OutputPath`, the file **AzureCloudCapabilities.json** is created in the current directory. Use your actual Azure location:
1. Make sure you have connectivity to Azure Stack Hub. These steps can be done from the Azure Stack Development Kit (ASDK) host, or you can use a [VPN](../asdk/asdk-connect.md#connect-to-azure-stack-using-vpn) to connect from your workstation.
56
-
2. Import the **AzureRM.CloudCapabilities** PowerShell module:
53
+
1. Make sure you have connectivity to Azure Stack Hub. These steps can be done from a VPN to connect from your workstation.
54
+
1. Import the **AzureRM.CloudCapabilities** PowerShell module:
3. Use the **Get-CloudCapabilities** cmdlet to retrieve service versions and create a cloud capabilities JSON file. If you don't specify `-OutputPath`, the file **AzureCloudCapabilities.json** is created in the current directory. Use your actual Azure location:
60
+
1. Use the `Get-CloudCapabilities` cmdlet to retrieve service versions and create a cloud capabilities JSON file. If you don't specify `-OutputPath`, the file **AzureCloudCapabilities.json** is created in the current directory. Use your actual Azure location:
@@ -75,35 +73,35 @@ Use these steps to validate templates by using the **Az.TemplateValidator** Powe
75
73
76
74
1. Import the **Az.TemplateValidator.psm1** PowerShell module:
77
75
78
-
```powershell
79
-
cd "c:\AzureStack-Tools-az\TemplateValidator"
80
-
Import-Module .\Az.TemplateValidator.psm1
81
-
```
76
+
```powershell
77
+
cd "c:\AzureStack-Tools-az\TemplateValidator"
78
+
Import-Module .\Az.TemplateValidator.psm1
79
+
```
82
80
83
-
2. Run the template validator:
81
+
1. Run the template validator:
84
82
85
-
```powershell
86
-
Test-AzTemplate -TemplatePath <path to template.json or template folder> `
87
-
-CapabilitiesPath <path to cloudcapabilities.json> `
88
-
-Verbose
89
-
```
83
+
```powershell
84
+
Test-AzTemplate -TemplatePath <path to template.json or template folder> `
85
+
-CapabilitiesPath <path to cloudcapabilities.json> `
86
+
-Verbose
87
+
```
90
88
91
89
### [AzureRM modules](#tab/azurerm2)
92
90
93
91
1. Import the **AzureRM.TemplateValidator.psm1** PowerShell module:
94
92
95
-
```powershell
96
-
cd "c:\AzureStack-Tools-az\TemplateValidator"
97
-
Import-Module .\AzureRM.TemplateValidator.psm1
98
-
```
93
+
```powershell
94
+
cd "c:\AzureStack-Tools-az\TemplateValidator"
95
+
Import-Module .\AzureRM.TemplateValidator.psm1
96
+
```
99
97
100
-
2. Run the template validator:
98
+
1. Run the template validator:
101
99
102
-
```powershell
103
-
Test-AzureRMTemplate -TemplatePath <path to template.json or template folder> `
104
-
-CapabilitiesPath <path to cloudcapabilities.json> `
105
-
-Verbose
106
-
```
100
+
```powershell
101
+
Test-AzureRMTemplate -TemplatePath <path to template.json or template folder> `
102
+
-CapabilitiesPath <path to cloudcapabilities.json> `
103
+
-Verbose
104
+
```
107
105
108
106
---
109
107
@@ -127,7 +125,7 @@ The template validator cmdlet supports the following parameters.
127
125
128
126
### Examples
129
127
130
-
This example validates all of the [Azure Stack Hub Quickstart templates](https://github.com/Azure/AzureStack-QuickStart-Templates) downloaded to local storage. The example also validates virtual machine (VM) sizes and extensions against ASDK capabilities.
128
+
This example validates all the [Azure Stack Hub Quickstart templates](https://github.com/Azure/AzureStack-QuickStart-Templates) downloaded to local storage.
0 commit comments