Skip to content

Commit 4c99625

Browse files
committed
More
1 parent 33662da commit 4c99625

7 files changed

+236
-280
lines changed

azure-stack/user/azure-stack-network-howto-vnet-to-vnet-stacks.md

Lines changed: 71 additions & 101 deletions
Large diffs are not rendered by default.

azure-stack/user/azure-stack-powershell-configure-user.md

Lines changed: 21 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,10 @@
22
title: Connect to Azure Stack Hub with PowerShell as a user
33
description: Learn how to connect to Azure Stack Hub with PowerShell to use the interactive prompt or write scripts.
44
author: sethmanheim
5-
65
ms.topic: article
76
ms.custom:
87
- devx-track-azurepowershell
9-
ms.date: 11/22/2020
8+
ms.date: 03/06/2025
109
ms.author: sethm
1110
ms.reviewer: thoroet
1211
ms.lastreviewed: 11/22/2020
@@ -20,25 +19,23 @@ ms.lastreviewed: 11/22/2020
2019

2120
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.
2221

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.
2827

2928
## Prerequisites to connecting with PowerShell
3029

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.
3231

33-
* Install [Azure Stack Hub-compatible Azure PowerShell modules](../operator/powershell-install-az-module.md).
34-
* Download the [tools required to work with Azure Stack Hub](../operator/azure-stack-powershell-download.md).
32+
- Install the [Azure Stack Hub-compatible Azure PowerShell modules](../operator/powershell-install-az-module.md).
33+
- Download the [tools required to work with Azure Stack Hub](../operator/azure-stack-powershell-download.md).
3534

3635
Make sure you replace the following script variables with values from your Azure Stack Hub configuration:
3736

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.
4239

4340
<a name='connect-to-azure-stack-hub-with-azure-ad'></a>
4441

@@ -57,8 +54,9 @@ Make sure you replace the following script variables with values from your Azure
5754
# can be easily targeted at your Azure Stack Hub instance.
5855
Connect-AzAccount -EnvironmentName "AzureStackUser" -TenantId $TenantId
5956
```
57+
6058
### [AzureRM modules](#tab/azurerm1)
61-
59+
6260
```powershell
6361
Add-AzureRMEnvironment -Name "AzureStackUser" -ArmEndpoint "https://management.local.azurestack.external"
6462
# Set your tenant name
@@ -73,7 +71,6 @@ Make sure you replace the following script variables with values from your Azure
7371

7472
---
7573

76-
7774
## Connect to Azure Stack Hub with AD FS
7875

7976
### [Az modules](#tab/az2)
@@ -85,8 +82,9 @@ Make sure you replace the following script variables with values from your Azure
8582
# Sign in to your environment
8683
Connect-AzAccount -EnvironmentName "AzureStackUser"
8784
```
85+
8886
### [AzureRM modules](#tab/azurerm2)
89-
87+
9088
```powershell
9189
# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance
9290
Add-AzureRMEnvironment -Name "AzureStackUser" -ArmEndpoint "https://management.local.azurestack.external"
@@ -97,7 +95,6 @@ Make sure you replace the following script variables with values from your Azure
9795

9896
---
9997

100-
10198
## Register resource providers
10299

103100
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)) {
111108
Get-AzResourceProvider -ListAvailable | Register-AzResourceProvider
112109
}
113110
```
111+
114112
### [AzureRM modules](#tab/azurerm3)
115-
113+
116114
```powershell
117115
foreach($s in (Get-AzureRMSubscription)) {
118116
Select-AzureRMSubscription -SubscriptionId $s.SubscriptionId | Out-Null
@@ -123,27 +121,26 @@ Get-AzureRMResourceProvider -ListAvailable | Register-AzureRMResourceProvider
123121

124122
---
125123

126-
127-
[!Include [AD FS only supports interactive authentication with user identities](../includes/note-powershell-adfs.md)]
124+
[!INCLUDE [note-powershell-adfs](../includes/note-powershell-adfs.md)]
128125

129126
## Test the connectivity
130127

131-
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`:
132129

133130
### [Az modules](#tab/az4)
131+
134132
```powershell
135133
New-AzResourceGroup -Name "MyResourceGroup" -Location "Local"
136134
```
137135

138136
### [AzureRM modules](#tab/azurerm4)
139-
137+
140138
```powershell
141139
New-AzureRMResourceGroup -Name "MyResourceGroup" -Location "Local"
142140
```
143141

144142
---
145143

146-
147144
## Next steps
148145

149146
- [Develop templates for Azure Stack Hub](azure-stack-develop-templates.md)

azure-stack/user/azure-stack-quick-create-vm-linux-cli.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,8 @@
22
title: Create Linux VM with Azure CLI in Azure Stack Hub
33
description: Create a Linux virtual machine by using the Azure CLI in Azure Stack Hub.
44
author: sethmanheim
5-
65
ms.topic: quickstart
7-
ms.date: 03/12/2024
6+
ms.date: 03/06/2025
87
ms.author: sethm
98

109
# 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
2322

2423
## Prerequisites
2524

25+
Before you begin, make sure you have the following prerequisites:
26+
2627
* A Linux image in the Azure Stack Hub Marketplace
2728

2829
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).
2930

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).
3132

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).
3334

3435
## Create a resource group
3536

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.
3738

3839
> [!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.
4041
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:
4243

4344
```azurecli
4445
az group create --name myResourceGroup --location local
4546
```
4647

4748
## Create a virtual machine
4849

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.
5051

5152
```azurecli
5253
az vm create \
@@ -58,19 +59,19 @@ az vm create \
5859
--location local
5960
```
6061

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.
6263

6364
## Open port 80 for web traffic
6465

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:
6667

6768
```azurecli
6869
az vm open-port --port 80 --resource-group myResourceGroup --name myVM
6970
```
7071

7172
## Use SSH to connect to the virtual machine
7273

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:
7475

7576
```bash
7677
ssh <publicIpAddress>

azure-stack/user/azure-stack-storage-connect-se.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Connect Storage Explorer to Azure Stack Hub subscription or storage accou
33
description: Learn how to connect Storage Explorer to an Azure Stack Hub subscription.
44
author: sethmanheim
55
ms.topic: conceptual
6-
ms.date: 02/20/2025
6+
ms.date: 03/06/2025
77
ms.author: sethm
88
ms.reviewer: xiaofmao
99
ms.lastreviewed: 11/11/2019
@@ -24,9 +24,7 @@ After you connect to an Azure Stack Hub subscription or storage account, see the
2424

2525
## Prepare for connecting to Azure Stack Hub
2626

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.
3028

3129
> [!NOTE]
3230
> 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).

azure-stack/user/azure-stack-validate-templates.md

Lines changed: 40 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,9 @@
22
title: Use the template validation tool in Azure Stack Hub
33
description: Check templates for deployment to Azure Stack Hub with a template validation tool.
44
author: sethmanheim
5-
65
ms.topic: article
7-
ms.date: 10/27/2021
6+
ms.date: 03/06/2025
87
ms.author: sethm
9-
ms.reviewer: unknown
108
ms.lastreviewed: 10/27/2021
119

1210
# 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
3735
3836
### [Az modules](#tab/az1)
3937

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:
4240

43-
```powershell
44-
Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1
45-
```
41+
```powershell
42+
Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1
43+
```
4644

47-
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:
4846

49-
```powershell
50-
Get-AzCloudCapability -Location <your location> -Verbose
51-
```
47+
```powershell
48+
Get-AzCloudCapability -Location <your location> -Verbose
49+
```
5250

5351
### [AzureRM modules](#tab/azurerm1)
5452

55-
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:
5755

58-
```powershell
59-
Import-Module .\CloudCapabilities\AzureRM.CloudCapabilities.psm1
60-
```
56+
```powershell
57+
Import-Module .\CloudCapabilities\AzureRM.CloudCapabilities.psm1
58+
```
6159

62-
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:
6361

64-
```powershell
65-
Get-AzureRMCloudCapability -Location <your location> -Verbose
66-
```
62+
```powershell
63+
Get-AzureRMCloudCapability -Location <your location> -Verbose
64+
```
6765

6866
---
6967

@@ -75,35 +73,35 @@ Use these steps to validate templates by using the **Az.TemplateValidator** Powe
7573

7674
1. Import the **Az.TemplateValidator.psm1** PowerShell module:
7775

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+
```
8280

83-
2. Run the template validator:
81+
1. Run the template validator:
8482

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+
```
9088

9189
### [AzureRM modules](#tab/azurerm2)
9290

9391
1. Import the **AzureRM.TemplateValidator.psm1** PowerShell module:
9492

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+
```
9997

100-
2. Run the template validator:
98+
1. Run the template validator:
10199

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+
```
107105

108106
---
109107

@@ -127,7 +125,7 @@ The template validator cmdlet supports the following parameters.
127125

128126
### Examples
129127

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.
131129

132130
### [Az modules](#tab/az3)
133131

0 commit comments

Comments
 (0)