Microsoft Azure PowerShell
Clone or download
MiYanni Merge pull request #8334 from anusapan/iothub
Add serialization to IotHubRoutingEndpoint cmdlet
Latest commit d796220 Jan 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github change from dev to master Nov 30, 2018
documentation Update azure-powershell-developer-guide.md Jan 18, 2019
setup Version bump for release. Fix bug in VersionBumper.cs. Jan 9, 2019
src Merge pull request #8334 from anusapan/iothub Jan 19, 2019
tools Merge pull request #8334 from anusapan/iothub Jan 19, 2019
.dockerignore Made the module output folder be 'artifacts' at the repo root. Update… Dec 17, 2018
.gitattributes identified psd1, psm1, and ps1xml as text files Oct 31, 2017
.gitignore Merge branch 'folders-rename' into resourcemanager-folder-remove Jan 3, 2019
.travis.yml Made the module output folder be 'artifacts' at the repo root. Update… Dec 17, 2018
CONTRIBUTING.md Fixed src/ResourceManager and src\ResourceManager references in docs … Dec 28, 2018
ChangeLog.md Update change logs and version SignalR Jan 9, 2019
CodeSign.targets Made indentation (somewhat) consistent in build.proj and CodeSign.tar… Dec 26, 2018
Directory.Build.targets merge from upstream/master Dec 13, 2018
Dockerfile Made the module output folder be 'artifacts' at the repo root. Update… Dec 17, 2018
LICENSE.txt Release new KeyVault preview module (#6284) May 24, 2018
NuGet.Config merge from upstream/master Dec 13, 2018
README.md merge from upstream/master Dec 13, 2018
Repo.props Merge branch 'master' into artifacts-folder Dec 20, 2018
after.Azure.PowerShell.sln.targets merge from upstream/master Dec 13, 2018
appveyor.yml Release new KeyVault preview module (#6284) May 24, 2018
build.proj Merge pull request #8247 from MiYanni/command-length-fix Jan 8, 2019

README.md

AzureIcon PowershellIcon Microsoft Azure PowerShell

This repository contains PowerShell cmdlets for developers and administrators to develop, deploy, and manage Microsoft Azure applications.

Try it out in Azure Cloud Shell!

CloudShellIcon

Modules

Below is a table containing our Azure PowerShell rollup module.

Description Module Name PowerShell Gallery Link
Azure PowerShell Az Az

For a full list of modules found in this repository, please see the Azure PowerShell Modules document.

Installation

PowerShell Gallery

Run the following command in an elevated PowerShell session to install the rollup module for Azure PowerShell cmdlets:

Install-Module -Name Az

This module runs on Windows PowerShell with .NET Framework 4.7.2 or greater, or PowerShell Core. The Az module replaces AzureRM. You should not install Az side-by-side with AzureRM.

If you have an earlier version of the Azure PowerShell modules installed from the PowerShell Gallery and would like to update to the latest version, run the following commands in an elevated PowerShell session:

Update-Module -Name Az

Update-Module installs the new version side-by-side with previous versions. It does not uninstall the previous versions.

For detailed instructions on installing Azure PowerShell, please refer to the installation guide.

Usage

Log into Azure

To connect to Azure, use the Connect-AzAccount cmdlet:

# Device Code login - Provides a link to sign into Azure via your web browser
Connect-AzAccount

# Service Principal login - Use a previously created service principal to log in
Connect-AzAccount -ServicePrincipal -ApplicationId 'http://my-app' -Credential $PSCredential -TenantId $TenantId

To log into a specific cloud (AzureChinaCloud, AzureCloud, AzureGermanCloud, AzureUSGovernment), use the Environment parameter:

# Specific cloud login - Logs into the Azure China cloud
Connect-AzAccount -Environment AzureChinaCloud

Getting and setting your Azure PowerShell session context

A session context persists login information across Azure PowerShell modules and PowerShell instances. To view the context you are using in the current session, which contains the subscription and tenant, use the Get-AzContext cmdlet:

# Gets the Azure PowerShell context for the current PowerShell session
Get-AzContext

# Lists all available Azure PowerShell contexts in the current PowerShell session
Get-AzContext -ListAvailable

To get the subscriptions in a tenant, use the Get-AzSubscription cmdlet:

# Get all of the Azure subscriptions in your current Azure tenant
Get-AzSubscription

# Get all of the Azure subscriptions in a specific Azure tenant
Get-AzSubscription -TenantId $TenantId

To change the subscription that you are using for your current context, use the Set-AzContext cmdlet:

# Set the Azure PowerShell context to a specific Azure subscription
Set-AzContext -Subscription $SubscriptionName -Name 'MyContext'

# Set the Azure PowerShell context using piping
Get-AzSubscription -SubscriptionName $SubscriptionName | Set-AzureRmContext -Name 'MyContext'

For details on Azure PowerShell contexts, see our persisted credentials guide.

Discovering cmdlets

Use the Get-Command cmdlet to discover cmdlets within a specific module, or cmdlets that follow a specific search pattern:

# List all cmdlets in the Az.Accounts module
Get-Command -Module Az.Accounts

# List all cmdlets that contain VirtualNetwork
Get-Command -Name '*VirtualNetwork*'

# List all cmdlets that contain VM in the Az.Compute module
Get-Command -Module Az.Compute -Name '*VM*'

Cmdlet help and examples

To view the help content for a cmdlet, use the Get-Help cmdlet:

# View the basic help content for Get-AzSubscription
Get-Help -Name Get-AzSubscription

# View the examples for Get-AzSubscription
Get-Help -Name Get-AzSubscription -Examples

# View the full help content for Get-AzSubscription
Get-Help -Name Get-AzSubscription -Full

# View the help content for Get-AzSubscription on https://docs.microsoft.com
Get-Help -Name Get-AzSubscription -Online

For detailed instructions on using Azure PowerShell, please refer to the getting started guide.

Reporting Issues and Feedback

Issues

If you find any bugs when using the Azure PowerShell modules, please file an issue in our GitHub issues page. Please fill out the provided template with the appropriate information.

Alternatively, be sure to check out the Azure Community Support if you have issues with the cmdlets or Azure services.

Feedback

If there is a feature you would like to see in Azure PowerShell, please use the Send-Feedback cmdlet, or file an issue in our GitHub issues page to provide the Azure PowerShell team direct feedback.

Contribute Code

If you would like to become an active contributor to this project, please follow the instructions provided in Microsoft Azure Projects Contribution Guidelines.

Additional information about contributing to this repository can be found in the Contributing document and the Azure PowerShell Developer Guide document.

Learn More


This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.