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: documentation/announcing-az-module.md
+18-19Lines changed: 18 additions & 19 deletions
Original file line number
Diff line number
Diff line change
@@ -1,24 +1,24 @@
1
1
# Announcing New Module 'Az'
2
2
In August 2018 we released a new module, 'Az' which combines the functionality of the AzureRM and AzureRM.Netcore modules. Az runs on both PowerShell 5.1 and PowerShell Core. 'Az' ensures that the PowerShell and PowerShell Core cmdlets for managing Azure resources will always be in sync and up to date. In addition, Az will simplify and regularize the naming of Azure cmdlets, and the organization of Azure modules. Az is intended as a replacement for the AzureRM.Netcore and AzureRM modules.
3
3
4
-
Az currently ships in CloudShell, and can be found on the PowerShell Gallery [here](https://www.powershellgallery.com/packages/Az/)
4
+
Az currently ships in Cloud Shell, and can be found on the PowerShell Gallery [here](https://www.powershellgallery.com/packages/Az/)
5
5
6
6
Az is a new module, and reorganizing and simplifying cmdlet names involves breaking changes, so we have [added features to Az to make it easier to transition to the simplified, normalized names in your existing scripts](#migrating-from-azurerm).
7
7
8
8
## New Features
9
9
- PowerShell 5.1 and PowerShell Core support in the same module
10
10
- PowerShell Core Edition and PowerShell Desktop Edition cmdlets always in sync and up to date with latest Azure capabilities
11
-
- Shortened and Normalized cmdlet names - all cmdlets use the noun prefix 'Az'
12
-
- Normalized module Organization - data plane and management plane cmdlets in the same module for each service
11
+
- Shortened and normalized cmdlet names - all cmdlets use the noun prefix 'Az'
12
+
- Normalized module organization - data plane and management plane cmdlets in the same module for each service
13
13
- Enhanced authentication for Netcore
14
-
* Self-renewing Service Princpal Authentication
14
+
* Self-renewing Service Principal Authentication
15
15
* Service Principal Certificate Authentication (in the future)
16
16
- Enable/Disable-AzureRmAlias cmdlets to manage compatibility with scripts based on AzureRM
17
17
18
18
## Supported Platforms
19
19
- PowerShell 5.1 with .Net Framework 4.7.2 or later [Windows only]
20
-
- PowerShell Core 6.0 - Windows, Linux, MacOS
21
-
- PowerShell Core 6.1 - Windows, Linux, MacOS
20
+
- PowerShell Core 6.0 - Windows, Linux, macOS
21
+
- PowerShell Core 6.1 - Windows, Linux, macOS
22
22
23
23
## Timeline
24
24
- Initial Release - August 2018
@@ -27,7 +27,7 @@ Az is a new module, and reorganizing and simplifying cmdlet names involves break
27
27
28
28
29
29
## AzureRM Module Support
30
-
Azure RM will continue to be supported, and important bugs will be fixed, but new development and new Azure capabilities will be shipped only in Az starting December 2018
30
+
AzureRM will continue to be supported, and important bugs will be fixed, but new development and new Azure capabilities will be shipped only in Az starting December 2018.
31
31
32
32
## Migrating From AzureRM
33
33
@@ -37,8 +37,7 @@ To make it easier for existing scripts to migrate from AzureRM to Az, we have pr
37
37
PS C:\> Enable-AzureRmAlias
38
38
```
39
39
40
-
will enable Azure RM aliases in the Az module for the current PowerShell session. For your convenience, we have added a ```Scope``` parameter that will automatically
41
-
set up the AzureRm aliases in Az for every PowerShell session:
40
+
will enable AzureRM aliases in the Az module for the current PowerShell session. For your convenience, we have added a ```Scope``` parameter that will automatically set up the AzureRM aliases in Az for every PowerShell session:
42
41
43
42
```powershell
44
43
PC C:\> Enable-AzureRmAlias -Scope CurrentUser
@@ -50,7 +49,7 @@ Sets up AzureRM cmdlet name aliases in the Az module for all sessions started by
50
49
PS C:\> Enable-AzureRmAlias -Scope LocalMachine
51
50
```
52
51
53
-
Sets up AzureRM Cmdlet aliases in the Az module for all sessions started on this machine for any user. You can turn aliases off similarly using the ```Disable-AzureRmAlias``` cmdlet
52
+
sets up AzureRM cmdlet aliases in the Az module for all sessions started on this machine for any user. You can turn aliases off similarly using the ```Disable-AzureRmAlias``` cmdlet
For scripts that import modules directly, or use ```#Requires``` statements to specify required modules, references to ```AzureRM.*``` will need to be changed to the appropriate ```Az``` module. A current list of AzureRM modules and their Az equivalents are listed below. Note that this list is subject to change as module names in Az are updated through November 2018.
0 commit comments