Skip to content

Add AzureRM->Az migration notice to all AzureRM content. #1060

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 10, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/authenticate-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 05/15/2017
---
# Sign in with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell supports multiple authentication methods. The simplest way to get started is to sign in
interactively at the command line.

Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/context-persistence.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 08/31/2017
---
# Persisting user credentials across PowerShell sessions

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell offers a feature called **Azure Context Autosave**, which gives the following features:

- Retention of sign in information for reuse in new PowerShell sessions.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 05/15/2017
---
# Create an Azure service principal with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

If you plan to manage your app or service with Azure PowerShell, you should run it under an Azure
Active Directory (AAD) service principal, rather than your own credentials. This topic steps you
through creating a security principal with Azure PowerShell.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/formatting-output.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 03/30/2017

# Formatting query results

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

By default each PowerShell cmdlet has predefined formatting of output making it easy to read. PowerShell also provides the flexibility to adjust the output or convert the cmdlet output to a different format with the following cmdlets:

| Formatting | Conversion |
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/get-started-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 11/15/2017

# Getting started with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell is designed for managing and administering Azure resources from the command line,
and for building automation scripts that work against the Azure Resource Manager. You can use it in
your browser with [Azure Cloud Shell](/azure/cloud-shell/overview), or you can install it on your
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/install-azurerm-ps.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 03/27/2018

# Install Azure PowerShell on Windows with PowerShellGet

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This article explains the steps to install the Azure PowerShell modules for PowerShell 5.x for Windows using
PowerShellGet. PowerShellGet and module management is the preferred way to install Azure PowerShell but if you would rather install with
the Web Platform Installer or MSI package, see [Other installation methods](other-install.md).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 03/30/2017
---
# Manage multiple Azure subscriptions

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

If you are brand new to Azure, you probably only have a single subscription. But if you have been
using Azure for a while, you may have created multiple Azure subscriptions. You can configure Azure
PowerShell to execute commands against a particular subscription.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/migration-guide.4.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 05/01/2018

# Breaking changes for Microsoft Azure PowerShell 4.0.0

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This document serves as both a breaking change notification and migration guide for consumers of the Microsoft Azure PowerShell cmdlets. Each section describes both the impetus for the breaking change and the migration path of least resistance. For in-depth context, please refer to the pull request associated with each change.

## Table of Contents
Expand Down
4 changes: 2 additions & 2 deletions docs-conceptual/azurermps-4.4.1/other-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ ms.date: 09/06/2017
---
# Other installation methods

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell has multiple installation methods. Using PowerShellGet with the PowerShell Gallery
is the preferred method. Azure PowerShell can be installed on Windows using the Web Platform
Installer (WebPI) or by using the MSI file available from GitHub.

[!INCLUDE[az-replacing-azurerm.md](../includes/az-replacing-azurerm.md)]

## Install on Windows using the Web Platform Installer

Installing the latest Azure PowerShell from WebPI is the same as it was for previous versions.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/queries-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 03/30/2017

# Querying for Azure resources

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Querying in PowerShell can be completed by using built-in cmdlets. In
PowerShell, cmdlet names take the form of **_Verb-Noun_**. The cmdlets using the verb **_Get_** are
the query cmdlets. The cmdlet nouns are the types of Azure resources that are acted upon by the
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/release-notes-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ ms.date: 07/26/2017

# Release notes

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This is a list of changes made to Azure PowerShell in this release.

## 2017.09.25 - Version 4.4.0
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-4.4.1/using-experimental-modules.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 09/05/2017
---
# Using experimental Azure PowerShell modules

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

With the emphasis on developer tools (especially CLIs) in Azure, the Azure PowerShell team is
experimenting with many improvements to the Azure PowerShell experience.

Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/authenticate-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 05/15/2017
---
# Sign in with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell supports multiple authentication methods. The simplest way to get started is to sign in
interactively at the command line.

Expand Down
3 changes: 3 additions & 0 deletions docs-conceptual/azurermps-5.7.0/azureps-vm-tutorial.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,9 @@ metadata:
items:
- durationInMinutes: 1
content: |-

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

In this tutorial, you learn all of the steps involved in setting up a virtual machine with
Azure PowerShell. The tutorial also covers output queries, Azure resource reuse, and
resource cleanup.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/context-persistence.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 08/31/2017
---
# Persisting user credentials across PowerShell sessions

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell offers a feature called **Azure Context Autosave**, which gives the following features:

- Retention of sign in information for reuse in new PowerShell sessions.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 05/15/2017
---
# Create an Azure service principal with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

If you plan to manage your app or service with Azure PowerShell, you should run it under an Azure
Active Directory (AAD) service principal, rather than your own credentials. This topic steps you
through creating a security principal with Azure PowerShell.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/formatting-output.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 06/07/2018

# Format AzurePowerShell cmdlet output

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

By default each Azure PowerShell cmdlet has predefined formatting of output making it easy to read. PowerShell also provides the flexibility to adjust the output or convert the cmdlet output to a different format with the following cmdlets:

| Formatting | Conversion |
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/get-started-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 11/15/2017

# Get started with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell is designed for managing and administering Azure resources from the command line,
and for building automation scripts that work against the Azure Resource Manager. You can use it in
your browser with [Azure Cloud Shell](/azure/cloud-shell/overview) or you install it on your
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/install-azurerm-ps.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 06/15/2018

# Install Azure PowerShell on Windows with PowerShellGet

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This article explains the steps to install the Azure PowerShell modules for PowerShell 5.x for Windows using
PowerShellGet. PowerShellGet and module management is the preferred way to install Azure PowerShell but if you would rather install with
the Web Platform Installer or MSI package, see [Other installation methods](other-install.md).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 03/30/2017
---
# Manage multiple Azure subscriptions

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

If you are brand new to Azure, you probably only have a single subscription. But if you have been
using Azure for a while, you may have created multiple Azure subscriptions. You can configure Azure
PowerShell to execute commands against a particular subscription.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/migration-guide.5.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 05/01/2018
---
# Breaking changes for Microsoft Azure PowerShell 5.0.0

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This document serves as both a breaking change notification and migration guide for consumers of the Microsoft Azure PowerShell cmdlets. Each section describes both the impetus for the breaking change and the migration path of least resistance. For in-depth context, please refer to the pull request associated with each change.

## Table of Contents
Expand Down
4 changes: 2 additions & 2 deletions docs-conceptual/azurermps-5.7.0/other-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@ ms.date: 06/20/2018
---
# Install Azure PowerShell on Windows with MSI or Web Platform Installer

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This article explains how to install Azure PowerShell on Windows using an MSI or Web Platform Installer (WebPI).
Use these installation methods only if they're necessary for your system. The recommended way to install Azure PowerShell
on Windows is with PowerShellGet. For instructions on using PowerShellGet to install Azure PowerShell,
see [Install Azure PowerShell with PowerShellGet](install-azurerm-ps.md).

[!INCLUDE[az-replacing-azurerm.md](../includes/az-replacing-azurerm.md)]

## Install or update on Windows using the MSI Package

Azure PowerShell can be installed using the MSI file available from
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/queries-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 06/08/2018
---
# Query output of Azure PowerShell cmdlets

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Querying in PowerShell can be completed by using built-in cmdlets. In
PowerShell, cmdlet names take the form of **_Verb-Noun_**. The cmdlets using the verb **_Get_** are
the query cmdlets. The cmdlet nouns are the types of Azure resources that are acted upon by the
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/release-notes-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ ms.date: 2/20/2018

# Release notes

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This is a list of changes made to Azure PowerShell in this release.

---
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/uninstall-azurerm-ps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.topic: conceptual
---
# Uninstall the Azure PowerShell module

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This article tells you how to uninstall an older version of Azure PowerShell, or completely remove it from
your system. If you've decided to completely uninstall the Azure PowerShell, please give us some feedback
through the [Send-Feedback](/powershell/module/azurerm.profile/send-feedback) cmdlet.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/using-experimental-modules.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 09/05/2017
---
# Using experimental Azure PowerShell modules

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

With the emphasis on developer tools (especially CLIs) in Azure, the Azure PowerShell team is
experimenting with many improvements to the Azure PowerShell experience.

Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-5.7.0/using-psjobs.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 12/11/2017

# Running cmdlets in parallel using PowerShell jobs

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

PowerShell supports asynchronous action with [PowerShell Jobs](/powershell/module/microsoft.powershell.core/about/about_jobs).
Azure PowerShell is heavily dependent on making, and waiting for, network calls to Azure. As a
developer, you may often find yourself looking to make multiple non-blocking calls to Azure in a
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/authenticate-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 09/09/2018
---
# Sign in with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell supports several authentication methods. The simplest way to get started is to sign in
interactively at the command line.

Expand Down
3 changes: 3 additions & 0 deletions docs-conceptual/azurermps-6.13.0/azureps-vm-tutorial.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,9 @@ metadata:
items:
- durationInMinutes: 1
content: |-

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

In this tutorial, you learn all of the steps involved in setting up a virtual machine with
Azure PowerShell. The tutorial also covers output queries, Azure resource reuse, and
resource cleanup.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/context-persistence.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 09/09/2018
---
# Persist user credentials across PowerShell sessions

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell offers a feature called **Azure Context Autosave**, which gives the following features:

- Retention of sign-in information for reuse in new PowerShell sessions.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 09/09/2018
---
# Create an Azure service principal with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

If you plan to manage your app or service with Azure PowerShell, you should run it under an Azure
Active Directory (AAD) service principal, rather than your own credentials. This article steps you
through creating a security principal with Azure PowerShell.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/formatting-output.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 09/09/2018

# Format AzurePowerShell cmdlet output

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

By default each Azure PowerShell cmdlet has predefined formatting of output making it easy to read. PowerShell also provides the flexibility to adjust the output or convert the cmdlet output to a different format with the following cmdlets:

| Formatting | Conversion |
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/get-started-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 09/11/2018

# Get started with Azure PowerShell

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Azure PowerShell is designed for managing and administering Azure resources from the command line,
and for building automation scripts that work against the Azure Resource Manager. You can use it in
your browser with [Azure Cloud Shell](/azure/cloud-shell/overview) or you install it on your
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/install-azurerm-ps.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 11/16/2018

# Install Azure PowerShell on Windows with PowerShellGet

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This article explains the steps to install the Azure PowerShell modules for PowerShell 5.x for Windows using
PowerShellGet. PowerShellGet and module management is the preferred way to install Azure PowerShell but if you would rather install with
the Web Platform Installer or MSI package, see [Other installation methods](other-install.md).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 09/11/2018

# Manage multiple Azure subscriptions

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

If you're brand new to Azure, you probably only have a single subscription. But if you have been
using Azure for a while, you may have created multiple Azure subscriptions. You can configure Azure
PowerShell to execute commands against a particular subscription.
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/migration-guide.6.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 05/01/2018
---
# Breaking changes for Microsoft Azure PowerShell 6.0.0

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This document serves as both a breaking change notification and migration guide for consumers of the Microsoft Azure PowerShell cmdlets. Each section describes both the impetus for the breaking change and the migration path of least resistance. For in-depth context, please refer to the pull request associated with each change.

## Table of Contents
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/other-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 11/16/2018

# Install Azure PowerShell on Windows with MSI

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This article explains how to install Azure PowerShell on Windows using an MSI installer.
Use these installation methods only if they're necessary for your system. The recommended way to install Azure PowerShell
on Windows is with PowerShellGet. For instructions on using PowerShellGet to install Azure PowerShell,
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/queries-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 09/11/2018
---
# Query output of Azure PowerShell cmdlets

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

Querying in PowerShell can be completed by using built-in cmdlets. In
PowerShell, cmdlet names take the form of **_Verb-Noun_**. The cmdlets using the verb **_Get_** are
the query cmdlets. The cmdlet nouns are the types of Azure resources that are acted upon by the
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/release-notes-azureps.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ ms.date: 08/28/2018

# Release notes

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This is a list of changes made to Azure PowerShell in this release.

---
Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/uninstall-azurerm-ps.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.topic: conceptual
---
# Uninstall the Azure PowerShell module

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

This article tells you how to uninstall an older version of Azure PowerShell, or completely remove it from
your system. If you've decided to completely uninstall the Azure PowerShell, give us some feedback
through the [Send-Feedback](/powershell/module/azurerm.profile/send-feedback) cmdlet.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,8 @@ ms.date: 09/11/2018
---
# Use experimental Azure PowerShell modules

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

With the emphasis on developer tools (especially CLIs) in Azure, the Azure PowerShell team is
experimenting with many improvements to the Azure PowerShell experience.

Expand Down
2 changes: 2 additions & 0 deletions docs-conceptual/azurermps-6.13.0/using-psjobs.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ ms.date: 09/11/2018

# Running cmdlets in parallel using PowerShell jobs

[!INCLUDE [migrate-to-az](../includes/migrate-to-az.md)]

PowerShell supports asynchronous action with [PowerShell Jobs](/powershell/module/microsoft.powershell.core/about/about_jobs).
Azure PowerShell is heavily dependent on making, and waiting for, network calls to Azure. You
may often find yourself needing to make non-blocking calls. To address this need, Azure PowerShell
Expand Down
Loading