chef-partners/azure-powershell

Name: azure-powershell

Owner: Chef Partners

Description: Microsoft Azure PowerShell

Created: 2015-09-16 05:31:35.0

Updated: 2015-09-16 05:31:52.0

Pushed: 2015-09-16 05:34:34.0

Homepage: null

Size: 87899

Language: C#

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Microsoft Azure PowerShell

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

Features

For detail descriptions and examples of the cmdlets, type

Supported Environments
Installation
Microsoft Web Platform Installer
  1. Install Microsoft Web Platform Installer.
  2. Open Microsoft Web Platform Installer and search for Microsoft Azure PowerShell.
  3. Install.

You can also find the standalone installers for all the versions at Downloads

Source Code
  1. Download the source code from GitHub repo
  2. Follow the Microsoft Azure PowerShell Developer Guide
Supported PowerShell Versions
Get Started

In general, following are the steps to start using Microsoft Azure PowerShell

The first step can be different for different environment you are targeting. Following are detail instructions for each supported environment.

Microsoft Azure

If you use both mechanisms on the same subscription, Microsoft Azure Active Directory authentication always wins. If you want to go back to management certificate authentication, please use Remove-AzureAccount, which will remove the Microsoft Azure Active Directory information and bring management certificate authentication back in.

Login directly from PowerShell (Microsoft Azure Active Directory authentication)
p up an embedded browser control for you to login
AzureAccount

e the cmdlets to manage your services/applications
AzureWebsite -Name mywebsite -Location "West US"
Use publish settings file (Management certificate authentication)
wnload a file which contains the publish settings information of your subscription.
is will open a browser window and ask you to log in to get the file.
AzurePublishSettingsFile

port the file you just downloaded.
tice that the file contains credential of your subscription so you don't want to make it public
ike check in to source control, etc.).
rt-AzurePublishSettingsFile "<file location>"

e the cmdlets to manage your services/applications
AzureWebsite -Name mywebsite -Location "West US"
Microsoft Azure China
eck the environment supported by your Microsoft Azure PowerShell installation.
AzureEnvironment

wnload a file which contains the publish settings information of your subscription.
e the -Environment parameter to target Microsoft Azure China.
is will open a browser window and ask you to log in to get the file.
AzurePublishSettingsFile -Environment "AzureChinaCloud"

port the file you just downloaded.
tice that the file contains credential of your subscription so you don't want to make it public
ike check in to source control, etc.).
rt-AzurePublishSettingsFile "<file location>"

e the cmdlets to manage your services/applications
AzureWebsite -Name mywebsite -Location "China East"
Windows Azure Pack
d your Windows Azure Pack environment to your Microsoft Azure PowerShell installation.
u will need to know the following information of your Windows Azure Pack environment.
 URL to download the publish settings file    Mandatory
 Management service endpoint                  Optional
 Management Portal URL                        Optional
 Storage service endpoint                     Optional
WAPackEnvironment -Name "MyWAPackEnv" `
-PublishSettingsFileUrl "URL to download the publish settings file>" `
-ServiceEndpoint "<Management service endpoint>" `
-ManagementPortalUrl "<Storage service endpoint>" `
-StorageEndpoint "<Management Portal URL>"

wnload a file which contains the publish settings information of your subscription.
e the -Environment parameter to target your Windows Azure Pack environment.
is will open a browser window and ask you to log in to get the file.
WAPackPublishSettingsFile -Environment "MyWAPackEnv"

port the file you just downloaded.
tice that the file contains credential of your subscription so you don't want to make it public
ike check in to source control, etc.).
rt-WAPackPublishSettingsFile "<file location>"

e the cmdlets to manage your services/applications
WAPackWebsite -Name mywebsite
2 Modes

Starting from 0.8.0, we are adding a separate mode for Resource Manager. You can use the following cmdlet to switch between the

They are not designed to work together.

ch-AzureMode AzureServiceManagement
ch-AzureMode AzureResourceManager
Find Your Way

All the cmdlets can be put into 3 categories:

  1. Cmdlets support both Microsoft Azure and Windows Azure Pack

  2. Cmdlets only support both Microsoft Azure

  3. Cmdlets only support Windows Azure Pack

  4. For category 1, we are using an “Azure” prefix in the cmdlet name and adding an alias with “WAPack” prefix.

  5. For category 2, we are using an “Azure” prefix in the cmdlet name.

  6. For category 2, we are using an “WAPack” prefix in the cmdlet name.

So you can use the following cmdlet to find out all the cmdlets for your environment

turn all the cmdlets for Microsoft Azure
Command *Azure*

turn all the cmdlets for Windows Azure Pack
Command *WAPack*

If you want to migrate some scripts from Microsoft Azure to Windows Azure Pack or vice versa, as long as the cmdlets you are using are in category 1, you should be able to migrate smoothly.

Need Help?

Be sure to check out the Microsoft 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 Microsoft Azure Projects Contribution Guidelines.

If you encounter any bugs with the library please file an issue in the Issues section of the project.

Learn More


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.