These Dockerfiles enable executing Azure-PowerShell cmdlets in a container for the supported OS.

This image requires Docker 17.05 or newer.

It is also expected that you are able to run Docker without sudo. Please follow Docker's official instructions to install docker correctly.

The release containers derive from the Powershell image, and then install the current Az package. Starting with Az 3.6.1 the images are using PowerShell 7, the previous versions are using PowerShell 6.2.4.

Azure PowerShell release notes

docker pull mcr.microsoft.com/azure-powershell

• To run azure-powershell using a container in an interactive mode:

$ docker run -it mcr.microsoft.com/azure-powershell pwsh 

• To run azure-powershell from using a container in an interactive mode using host authentication:

  1- Make sure that $HOME/.Azure is present on the host (default location) 2- You may need to grant access this location for the docker process.

$ docker run -it -v ~/.Azure/AzureRmContext.json:/root/.Azure/AzureRmContext.json -v ~/.Azure/TokenCache.dat:/root/.Azure/TokenCache.dat mcr.microsoft.com/azure-powershell pwsh 

Verify the host authentication:

docker run -it --rm -v ~/.Azure/AzureRmContext.json:/root/.Azure/AzureRmContext.json -v ~/.Azure/TokenCache.dat:/root/.Azure/TokenCache.dat mcr.microsoft.com/azure-powershell pwsh -c Get-AzContext

Clone the azure-powershell repo, and in your local copy run the following commands:

$ dotnet msbuild /t:Build /p:Configuration=Release
$ dotnet msbuild /t:publish /p:Configuration=Release /p:NuGetKey=1234
$ dotnet msbuild /t:BuildImage /p:DockerImageName=mcr.microsoft.com/azure-powershell
$ docker images

docker rmi mcr.microsoft.com/azure-powershell

Please see the Contribution Guide for general information about how to develop and contribute.

If you have any problems, please consult the GitHub issues. If you do not see your problem captured, please file a new issue and follow the provided template.

Azure-PowerShell is licensed under the Apache license.

PowerShell is licensed under the MIT license.

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.