Windows Azure PowerShell
This repository contains a set of PowerShell cmdlets for developers and administrators to develop, deploy and manage Windows Azure applications.
For documentation on how to build and deploy applications to Windows Azure please see the Windows Azure Developer Center. For comprehensive documentation on the developer cmdlets see How to use Windows Azure PowerShell. For comprehensive documentation on the full set of Windows Azure cmdlets see Windows Azure Management Center.
- Get and import Azure publish settings
- Get the differnet out-of-box Windows Azure environments (like AzureCloud and AzureChinaCloud)
- Get Azure publish settings for a particular environment
- Manage Azure subscription
- Manage AffinityGroup
- Manage website, such as CRUD, start and stop.
- Configure site and application diagnostics
- Log streaming
- Save log
- Cloud Services
- Create scaffolding for cloud service and role. Role support includes Node.js, PHP, Django and Cache.
- Manage cloud service and role, such as CRUD, start and stop.
- Enable/Disable remote desktop.
- Start/Stop Azure emulator.
- Manage certificate.
- Manage cloud service extensions
- Remote desktoo
- Manage storage account and access key.
- Manage storage container and blob.
- Copy storage blob.
- Manage storage table.
- Manage storage queue.
- SQL Azure
- CRUD support for database server, database and firewall rule
- Service Bus
- Manage service bus namespaces.
- Manage VM, such as CRUD, import/export and start/stop/restart.
- Manage VM image, such as CRUD.
- Manage disk, such as CRUD.
- Manage VM endpoint, such as CRUD and ACL.
- Get/Set VM sub net.
- Manage certificate and SSH key.
- PowerShell remoting
- Manage deployment, such as CRUD, move, upgrade and restore.
- Get/Create DNS settings of a deployment.
- Manage virtual network config, connection and gateway.
- View available Windows Azure Store Add-On plans.
- Purchase, view, upgrade and remove Windows Azure Store Add-On instances.
- Test whether a name is avaiable. Currently support cloud service name, storage account name and service bus namespace name.
- Get the list of geo locations supported by Azure.
- Get the list of OS supported by Azure.
- Direct you to Azure portal.
For detail descriptions and examples of the cmdlets, type
help azureto get all the cmdlets.
help node-devto get all Node.js development related cmdlets.
help php-devto get all PHP development related cmdlets.
help python-devto get all Python development related cmdlets.
get-help <cmdlet name>to get the details of a specific cmdlet.
Install from Microsoft Web Platform Installer
- Install Microsoft Web Platform Installer.
- Open Microsoft Web Platform Installer and search for Windows Azure PowerShell.
You can also find the list of previous versions at Downloads
Download Source Code
To get the source code of the SDK via git just type:
git clone https://github.com/WindowsAzure/azure-sdk-tools.git<br/>cd ./azure-sdk-tools
- Windows Azure SDK
- 0.6.9 or less
- 0.6.10 or more
- WiX (Only needed if you want to build the setup project)
Node.js Prerequisites (developer only)
PHP Prerequisites (developer only)
Configure PowerShell to automatically load commandlets
Create a folder inside your user's Documents folder and name it WindowsPowerShell
Inside that folder create a file called Microsoft.PowerShell_profile.ps1
Edit the file in a text editor and add the following contents
After you build the commandlets project, you can then open a PowerShell window and you should be able to use the commandlets. Please note that if you want to rebuild the project, you have close the PowerShell window, and then reopen it.
Create an Azure hosted service called HelloWorld by typing
Inside the HelloWorld folder, add a new Web Role by typing
Test out the application in the local emulator by typing
You are now ready to publish to the cloud service. Go ahead and register for a Windows Azure account and make sure you have your credentials handy.
Get your account's publish settings and save them to a file by typing
Get-AzurePublishSettingsFile. It will by default target the public Azure. If you want to target environment like Azure in China, use
Get-AzureEnvironmentto see the environments we support and use
Get-AzurePublishSettingsFile -Environmentto get the publish settings for the paticular environment.
Now import the settings
You are now ready to publish to the cloud. Make sure you specify a unique name for your application to ensure there aren't any conflicts during the publish process. Then type
Publish-AzureServiceProject -ServiceName UNIQUE_NAME -Launch
Be sure to check out the Windows Azure Developer Forums on Stack Overflow if you have trouble with the provided code.
Contribute Code or Provide Feedback
If you would like to become an active contributor to this project please follow the instructions provided in Windows Azure Projects Contribution Guidelines.
If you encounter any bugs with the library please file an issue in the Issues section of the project.