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: articles/azure-stack/asdk/asdk-post-deploy.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ You can use API version profiles to specify Azure Stack compatible AzureRM modu
39
39
You can install the latest Azure Stack PowerShell module with or without Internet connectivity to the ASDK host computer:
40
40
41
41
> [!IMPORTANT]
42
-
> Before installing the required version, make sure that you [uninstall any existing Azure PowerShell modules](.\.\azure-stack-powershell-install.md#uninstall-existing-versions-of-the-azure-stack-powershell-modules).
42
+
> Before installing the required version, make sure that you [uninstall any existing Azure PowerShell modules](.\.\azure-stack-powershell-install.md#3-uninstall-existing-versions-of-the-azure-stack-powershell-modules).
43
43
44
44
-**With an internet connection** from the ASDK host computer. Run the following PowerShell script to install these modules on your development kit installation:
Copy file name to clipboardExpand all lines: articles/azure-stack/azure-stack-powershell-install.md
+89-59Lines changed: 89 additions & 59 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ ms.workload: na
12
12
pms.tgt_pltfrm: na
13
13
ms.devlang: PowerShell
14
14
ms.topic: article
15
-
ms.date: 07/10/2018
15
+
ms.date: 08/10/2018
16
16
ms.author: mabrigg
17
17
ms.reviewer: thoroet
18
18
---
@@ -21,107 +21,137 @@ ms.reviewer: thoroet
21
21
22
22
*Applies to: Azure Stack integrated systems and Azure Stack Development Kit*
23
23
24
-
Azure Stack compatible Azure PowerShell modules are required to work with Azure Stack. In this guide, we walk you through the steps required to install PowerShell for Azure Stack. The following steps apply to internet connected environments. Scroll to the bottom of the page for disconnected environments.
24
+
You will need to install Azure Stack compatible PowerShell modules to work with your cloud. Compatibility is enabled through a feature called *API profiles*.
25
25
26
-
This article has detailed instructions to install PowerShell for Azure Stack.
26
+
API profiles provide a way to manage version differences between Azure and Azure Stack. An API version profile is a set of Azure Resource Manager PowerShell modules with specific API versions. Each cloud platform has a set of supported API version profiles. For example, Azure Stack supports a specific dated profile version such as **2017-03-09-profile**, and Azure supports the **latest** API version profile. When you install a profile, the Azure Resource Manager PowerShell modules that correspond to the specified profile are installed.
27
27
28
-
> [!Note]
29
-
> The following steps require at least PowerShell 5.0. To check your version, run $PSVersionTable.PSVersion and compare the **Major** version. If you do not have PowerShell 5.0, follow the [link](https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-windows-powershell?view=powershell-6#upgrading-existing-windows-powershell) to upgrade to PowerShell 5.0.
28
+
You can install Azure Stack compatible PowerShell modules in Internet connected, partially connected, or in a disconnected scenario. In this article, we walk you through the detailed instructions to install PowerShell for Azure Stack for these scenarios.
30
29
31
-
PowerShell commands for Azure Stack are installed through the PowerShell Gallery. You can use the following procedure to validate if PSGallery is registered as a repository, open an elevated PowerShell session and run the following command:
30
+
## 1. Verify your prerequisites
32
31
33
-
```PowerShell
34
-
#requires -Version 5
35
-
#requires -RunAsAdministrator
36
-
#requires -Module PowerShellGet
32
+
Before your get started with Azure Stack and PowerShell, you will need to have a few requirements in place.
To check your version, run $PSVersionTable.PSVersion and compare the **Major** version. If you do not have PowerShell 5.0, follow the [link](https://docs.microsoft.com/powershell/scripting/setup/installing-windows-powershell?view=powershell-6#upgrading-existing-windows-powershell) to upgrade to PowerShell 5.0.
36
+
37
+
> [!Note]
38
+
> PowerShell 5.0 requires a Windows machine.
39
+
40
+
-**Run Powershell an elevated prompt**
41
+
You will need to be able to run PowerShell with administrative privileges.
42
+
43
+
-**PowerShell Gallery access**
44
+
You will need access to the [PowerShell Gallery](https://www.powershellgallery.com). The gallery is the central repository for PowerShell content. The **PowerShellGet** module contains cmdlets for discovering, installing, updating, and publishing PowerShell artifacts such as modules, DSC resources, role capabilities, and scripts from the PowerShell Gallery and other private repositories. If you are using PowerShell in a disconnected scenario, you will need to retrieve resources from a machine with a connection to the Internet and store them in a location accessible to your disconnected machine.
45
+
46
+
47
+
<!-- Nuget? -->
48
+
49
+
## 2. Validate if the PowerShell Gallery is accessible
50
+
51
+
Validate if PSGallery is registered as a repository.
52
+
53
+
> [!Note]
54
+
> This step requires Internet access.
55
+
56
+
Open an elevated PowerShell prompt, and run the following cmdlets:
## Uninstall existing versions of the Azure Stack PowerShell modules
71
+
## 3. Uninstall existing versions of the Azure Stack PowerShell modules
54
72
55
73
Before installing the required version, make sure that you uninstall any previously installed Azure Stack AzureRM PowerShell modules. You can uninstall them by using one of the following two methods:
56
74
57
-
- To uninstall the existing AzureStack and AzureRM PowerShell modules, close all the active PowerShell sessions and run the following command:
75
+
1. To uninstall the existing AzureRM PowerShell modules, close all the active PowerShell sessions, and run the following cmdlets:
Get-Module -ListAvailable | Where Name -Like "Azs.*" | Uninstall-Module -Force -Verbose
64
-
```
83
+
2. Delete all the folders that start with `Azure` from the `C:\Program Files\WindowsPowerShell\Modules` and `C:\Users\AzureStackAdmin\Documents\WindowsPowerShell\Modules` folders. Deleting these folders removes any existing PowerShell modules.
65
84
66
-
- Delete all the folders that start with "Azure" from the `C:\Program Files\WindowsPowerShell\Modules` and `C:\Users\AzureStackAdmin\Documents\WindowsPowerShell\Modules` folders. Deleting these folders removes any existing PowerShell modules.
85
+
## 4. Connected: Install PowerShell for Azure Stack with Internet connectivity
67
86
68
-
The following sections describe the steps required to install PowerShell for Azure Stack. PowerShell can be installed on Azure Stack that is operated in connected, partially connected, or in a disconnected scenario.
87
+
Azure Stack requires the **2017-03-09-profile** API version profile, which is available by installing the **AzureRM.Bootstrapper** module. In addition to the AzureRM modules, you should also install the Azure Stack-specific PowerShell modules.
69
88
70
-
## Install the Azure Stack PowerShell modules in a connected scenario (with Internet connectivity)
89
+
Run the following PowerShell script to install these modules on your development workstation:
71
90
72
-
Azure Stack compatible AzureRM modules are installed through API version profiles. Azure Stack requires the **2017-03-09-profile** API version profile, which is available by installing the AzureRM.Bootstrapper module. To learn about API version profiles and the cmdlets provided by them, refer to the [manage API version profiles](user/azure-stack-version-profiles.md). In addition to the AzureRM modules, you should also install the Azure Stack-specific PowerShell modules. Run the following PowerShell script to install these modules on your development workstation:
91
+
-**Version 1.4.0** (Azure Stack 1804 or greater)
73
92
74
-
```PowerShell
75
-
# Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet
76
-
Install-Module -Name AzureRm.BootStrapper
93
+
```PowerShell
94
+
# Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet
95
+
Install-Module -Name AzureRm.BootStrapper
77
96
78
-
# Install and import the API Version Profile required by Azure Stack into the current PowerShell session.
If the installation is successful, the AzureRM and AzureStack modules are displayed in the output.
95
124
96
-
## Install the Azure Stack PowerShell modules in a disconnected or a partially connected scenario (with limited Internet connectivity)
125
+
## 5. Disconnected: Install PowerShell without an Internet connection
97
126
98
127
In a disconnected scenario, you must first download the PowerShell modules to a machine that has Internet connectivity, and then transfer them to the Azure Stack Development Kit for installation.
99
128
100
-
> [!IMPORTANT]
101
-
> The release of 1.4.0 AzureStack module does not have any breaking changes with the earlier version 1.3.0. Please refer to the [release notes](https://aka.ms/azspsh140release) for the changes in release 1.4.0. However the version 1.3.0 of AzureStack module has a list of breaking changes. To upgrade from the 1.2.11 version, see the [migration guide](https://aka.ms/azspowershellmigration).
129
+
Sign in to a computer where you have Internet connectivity and use the following scripts to download the Azure Resource Manager and AzureStack packages onto your local computer depending on your version of Azure Stack.
102
130
103
-
1. Sign in to a computer where you have internet connectivity and use the following script to download the AzureRM, and AzureStack packages onto your local computer:
0 commit comments