Skip to content

Commit 942a55d

Browse files
committed
Hub freshness pass
1 parent 1a797fb commit 942a55d

File tree

5 files changed

+89
-164
lines changed

5 files changed

+89
-164
lines changed

azure-stack/includes/note-powershell-adfs.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,8 @@ author: sethmanheim
33
ms.author: sethm
44
ms.service: azure-stack
55
ms.topic: include
6-
ms.date: 2/1/2021
7-
ms.reviewer: thoroet
8-
ms.lastreviewed: 08/04/2020
6+
ms.date: 01/24/2025
97
---
108

11-
> [!Note]
12-
> AD FS only supports interactive authentication with user identities. If a credential object is required, you must use a service principal (SPN). For more information on setting up a service principal with Azure Stack Hub and AD FS as your identity management service, see [Manage an AD FS app identity](../operator/give-app-access-to-resources.md#manage-an-azure-ad-app).
9+
> [!NOTE]
10+
> AD FS only supports interactive authentication with user identities. If a credential object is required, you must use a service principal (SPN). For more information about setting up a service principal with Azure Stack Hub and AD FS as your identity management service, see [Manage an AD FS app identity](../operator/give-app-access-to-resources.md#manage-an-azure-ad-app).

azure-stack/includes/remove-account-az.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,11 @@
22
title: Include for Remove-AzureRmAccount
33
description: An include file that explains how to run Remove-AzureRmAccount.
44
author: sethmanheim
5-
65
ms.topic: include
7-
ms.date: 11/23/2020
6+
ms.date: 01/23/2025
87
ms.author: sethm
9-
ms.reviewer: avishwan
108
ms.lastreviewed: 11/23/2020
119
---
1210

13-
>[!Note]
14-
>If your session expires, your password has changed, or you simply wish to switch accounts, run the following cmdlet before you sign in using Connect-AzAccount: `Remove-AzAccount -Scope Process`
11+
> [!NOTE]
12+
> If your session expires, your password has changed, or you want to switch accounts, run the following cmdlet before you sign in using `Connect-AzAccount`: `Remove-AzAccount -Scope Process`.

azure-stack/operator/azure-stack-powershell-configure-admin.md

Lines changed: 7 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,11 @@
22
title: Connect to Azure Stack Hub with PowerShell
33
description: Learn how to connect to Azure Stack Hub with PowerShell.
44
author: sethmanheim
5-
65
ms.topic: article
7-
ms.date: 2/1/2021
6+
ms.date: 01/24/2025
87
ms.author: sethm
98
ms.reviewer: thoroet
10-
ms.lastreviewed: 2/1/2021
9+
ms.lastreviewed: 02/01/2021
1110

1211
# Intent: As an Azure Stack operator, I want to learn how to connect to Azure Stack using Powershell.
1312
# Keyword: connect azure stack powershell
@@ -17,7 +16,7 @@ ms.lastreviewed: 2/1/2021
1716

1817
# Connect to Azure Stack Hub with PowerShell
1918

20-
You can configure Azure Stack Hub to use PowerShell to manage resources like creating offers, plans, quotas, and alerts. This topic helps you configure the operator environment.
19+
You can configure Azure Stack Hub to use PowerShell to manage resources like creating offers, plans, quotas, and alerts. This article helps you configure the operator environment.
2120

2221
## Prerequisites
2322

@@ -30,11 +29,9 @@ Run the following prerequisites either from the [Azure Stack Development Kit (AS
3029

3130
## Connect with Microsoft Entra ID
3231

33-
To configure the Azure Stack Hub operator environment with PowerShell, run one of the scripts below. Replace the Microsoft Entra tenantName and Azure Resource Manager endpoint values with your own environment configuration.
34-
35-
### [Az modules](#tab/az1)
32+
To configure the Azure Stack Hub operator environment with PowerShell, run the following script. Replace the Microsoft Entra tenantName and Azure Resource Manager endpoint values with your own environment configuration.
3633

37-
[!include[Remove Account](../includes/remove-account-az.md)]
34+
[!INCLUDE [remove-account-az](../includes/remove-account-az.md)]
3835

3936
```powershell
4037
# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
@@ -51,79 +48,17 @@ To configure the Azure Stack Hub operator environment with PowerShell, run one o
5148
# can be easily targeted at your Azure Stack Hub instance.
5249
Connect-AzAccount -EnvironmentName "AzureStackAdmin" -TenantId $TenantId
5350
```
54-
### [AzureRM modules](#tab/azurerm1)
55-
56-
[!include[Remove Account](../includes/remove-account-azurerm.md)]
57-
58-
```powershell
59-
# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
60-
Add-AzureRMEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
61-
-AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
62-
-AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external
63-
64-
# Set your tenant name.
65-
$AuthEndpoint = (Get-AzureRmEnvironment -Name "AzureStackAdmin").ActiveDirectoryAuthority.TrimEnd('/')
66-
$AADTenantName = "<myDirectoryTenantName>.onmicrosoft.com"
67-
$TenantId = (invoke-restmethod "$($AuthEndpoint)/$($AADTenantName)/.well-known/openid-configuration").issuer.TrimEnd('/').Split('/')[-1]
68-
69-
# After signing in to your environment, Azure Stack Hub cmdlets
70-
# can be easily targeted at your Azure Stack Hub instance.
71-
Add-AzureRmAccount -EnvironmentName "AzureStackAdmin" -TenantId $TenantId
72-
```
73-
74-
---
75-
76-
77-
## Connect with AD FS
78-
79-
Connect to the Azure Stack Hub operator environment with PowerShell with Microsoft Entra ID Federated Services (Azure AD FS). For the ASDK, this Azure Resource Manager endpoint is set to `https://adminmanagement.local.azurestack.external`. To get the Azure Resource Manager endpoint for Azure Stack Hub integrated systems, contact your service provider.
8051

81-
### [Az modules](#tab/az2)
82-
83-
```powershell
84-
# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
85-
Add-AzEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
86-
-AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
87-
-AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external
88-
89-
# Sign in to your environment.
90-
Connect-AzAccount -EnvironmentName "AzureStackAdmin"
91-
```
92-
93-
### [AzureRM modules](#tab/azurerm2)
94-
95-
```powershell
96-
# Register an Azure Resource Manager environment that targets your Azure Stack Hub instance. Get your Azure Resource Manager endpoint value from your service provider.
97-
Add-AzureRMEnvironment -Name "AzureStackAdmin" -ArmEndpoint "https://adminmanagement.local.azurestack.external" `
98-
-AzureKeyVaultDnsSuffix adminvault.local.azurestack.external `
99-
-AzureKeyVaultServiceEndpointResourceId https://adminvault.local.azurestack.external
100-
101-
# Sign in to your environment.
102-
Login-AzureRmAccount -EnvironmentName "AzureStackAdmin"
103-
```
104-
105-
---
106-
107-
[!Include [AD FS only supports interactive authentication with user identities](../includes/note-powershell-adfs.md)]
52+
[!INCLUDE [note-powershell-adfs](../includes/note-powershell-adfs.md)]
10853

10954
## Test the connectivity
11055

111-
Now that you've got everything set-up, use PowerShell to create resources within Azure Stack Hub. For example, you can create a resource group for an app and add a virtual machine. Use the following command to create a resource group named **MyResourceGroup**.
56+
Now that you have everything set up, use PowerShell to create resources within Azure Stack Hub. For example, you can create a resource group for an app and add a virtual machine. Use the following command to create a resource group named **MyResourceGroup**:
11257

113-
### [Az modules](#tab/az3)
11458
```powershell
11559
New-AzResourceGroup -Name "MyResourceGroup" -Location "Local"
11660
```
11761

118-
### [AzureRM modules](#tab/azurerm3)
119-
120-
```powershell
121-
New-AzureRmResourceGroup -Name "MyResourceGroup" -Location "Local"
122-
```
123-
124-
---
125-
126-
12762
## Next steps
12863

12964
- [Use PowerShell to manage subscriptions, plans, and offers in Azure Stack Hub](azure-stack-powershell-plan-offer.md)

azure-stack/user/azure-stack-kubernetes-aks-engine-overview.md

Lines changed: 12 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,10 @@
11
---
2-
title: What is AKS engine on Azure Stack Hub?
2+
title: What is the AKS engine on Azure Stack Hub?
33
description: Learn how to use the AKS engine command-line tool to deploy and manage a Kubernetes cluster on Azure and Azure Stack Hub.
44
author: sethmanheim
5-
65
ms.topic: article
7-
ms.date: 12/19/2022
6+
ms.date: 01/24/2025
87
ms.author: sethm
9-
ms.reviewer: waltero
108
ms.lastreviewed: 09/02/2020
119

1210
# Intent: As an Azure Stack Hub user, I want to learn how to use the AKS engine command-line so that I can deploy and manage a Kubernetes cluster on Azure and Azure Stack Hub.
@@ -15,31 +13,29 @@ ms.lastreviewed: 09/02/2020
1513
---
1614

1715

18-
# What is AKS engine on Azure Stack Hub?
16+
# What is the AKS engine on Azure Stack Hub?
1917

2018
You can use the AKS engine command-line tool to deploy and manage a Kubernetes cluster on Azure and Azure Stack Hub. Use AKS engine to create, upgrade, and scale Azure Resource Manager native clusters. You can use the engine to deploy a cluster in both connected and disconnected environments. This article provides an overview of AKS engine, supported scenarios for using the engine with Azure Stack Hub, and an introduction to operations such as deploy, upgrade, and scale.
2119

22-
## Overview of AKS engine
20+
## Overview of the AKS engine
2321

24-
[AKS engine](https://github.com/Azure/aks-engine) provides a command-line tool to bootstrap Kubernetes clusters on Azure and Azure Stack Hub. By using the Azure Resource Manager, AKS engine helps you create and maintain clusters running on VMs, virtual networks, and other infrastructure-as-a-service (IaaS) resources in Azure Stack Hub.
22+
The [AKS engine](https://github.com/Azure/aks-engine) provides a command-line tool to bootstrap Kubernetes clusters on Azure and Azure Stack Hub. By using the Azure Resource Manager, AKS engine helps you create and maintain clusters running on VMs, virtual networks, and other infrastructure-as-a-service (IaaS) resources in Azure Stack Hub.
2523

2624
## AKS engine on Azure Stack Hub considerations
2725

28-
Before you use AKS engine on Azure Stack Hub, it's important to understand the differences between Azure Stack Hub and Azure. This section identifies different features and key considerations when using Azure Stack Hub with AKS engine to manage your Kubernetes cluster.
29-
30-
For more information on the specifics of AKS engine on Azure Stack Hub and its differences with respect to Azure, see [AKS engine on Azure Stack Hub](https://github.com/Azure/aks-engine/blob/master/docs/topics/azure-stack.md).
26+
Before you use the AKS engine on Azure Stack Hub, it's important to understand the differences between Azure Stack Hub and Azure. This section identifies different features and key considerations when using Azure Stack Hub with AKS engine to manage your Kubernetes cluster.
3127

32-
For more information on AKS engine and Azure Stack Hub, see [Support policies for AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-support.md).
28+
For more information about the AKS engine and Azure Stack Hub, see [Support policies for AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-support.md).
3329

34-
## Install AKS engine and deploy a Kubernetes cluster
30+
## Install the AKS engine and deploy a Kubernetes cluster
3531

36-
To deploy a Kubernetes cluster with AKS engine on Azure Stack Hub:
32+
To deploy a Kubernetes cluster with the AKS engine on Azure Stack Hub:
3733

38-
1. [Set up the prerequisites for AKS engine](azure-stack-kubernetes-aks-engine-set-up.md)
39-
2. Install AKS engine on a machine with access to your Azure Stack Hub environment.
34+
1. [Set up the prerequisites for the AKS engine](azure-stack-kubernetes-aks-engine-set-up.md)
35+
1. Install the AKS engine on a machine with access to your Azure Stack Hub environment.
4036
- [Install AKS engine on Windows in Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-windows.md)
4137
- [Install AKS engine on Linux in Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-linux.md)
42-
3. [Deploy a Kubernetes cluster with AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-cluster.md)
38+
1. [Deploy a Kubernetes cluster with AKS engine on Azure Stack Hub](azure-stack-kubernetes-aks-engine-deploy-cluster.md)
4339

4440
## Next steps
4541

0 commit comments

Comments
 (0)