Merge branch 'preview' into Graham71298

Author: Graham Priestley

.github/PULL_REQUEST_TEMPLATE.md

@@ -11,24 +11,24 @@ If applicable, reference the bug/issue that this pull request fixes here.
 
 This checklist is used to make sure that common guidelines for a pull request are followed. You can find a more complete discussion of PowerShell cmdlet best practices [here](https://msdn.microsoft.com/en-us/library/dd878270(v=vs.85).aspx).
 
-- [ ] **I have read the [contribution guidelines](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md).**
-- [ ] **If changes were made to any cmdlet, the XML help was regenerated using the [platyPSHelp module](https://github.com/Azure/azure-powershell/blob/dev/documentation/platyPSHelp-documentation.md).**
-- [ ] **If any large changes are made to a service, they are reflected in the respective [change log](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md#updating-the-change-log).**
+- [ ] **I have read the [contribution guidelines](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md).**
+- [ ] **If changes were made to any cmdlet, the XML help was regenerated using the [platyPSHelp module](https://github.com/Azure/azure-powershell/blob/preview/documentation/help-generation.md).**
+- [ ] **If any large changes are made to a service, they are reflected in the respective [change log](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md#updating-the-change-log).**
 
-### [General Guidelines](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md#general-guidelines)
+### [General Guidelines](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md#general-guidelines)
 - [ ] Title of the pull request is clear and informative.
-- [ ] There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, [see this page](https://github.com/Azure/azure-powershell/blob/dev/documentation/cleaning-up-commits.md).
-- [ ] The pull request does not introduce [breaking changes](https://github.com/Azure/azure-powershell/blob/dev/documentation/breaking-changes.md) (unless a major version change occurs in the assembly and module).
+- [ ] There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, [see this page](https://github.com/Azure/azure-powershell/blob/preview/documentation/cleaning-up-commits.md).
+- [ ] The pull request does not introduce [breaking changes](https://github.com/Azure/azure-powershell/blob/preview/documentation/breaking-changes/breaking-changes-definition.md) (unless a major version change occurs in the assembly and module).
 
-### [Testing Guidelines](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md#testing-guidelines)
+### [Testing Guidelines](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md#testing-guidelines)
 - [ ] Pull request includes test coverage for the included changes.
 - [ ] PowerShell scripts used in tests should do any necessary setup as part of the test or suite setup, and should not use hard-coded values for locations or existing resources.
 
-### [Cmdlet Signature Guidelines](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md#cmdlet-signature-guidelines)
-- [ ] New cmdlets that make changes or have side effects should implement `ShouldProcess` and have `SupportShouldProcess=true` specified in the cmdlet attribute. You can find more information on `ShouldProcess` [here](https://gist.github.com/markcowl/338e16fe5c8bbf195aff9f8af0db585d#what-is-the-change).
+### [Cmdlet Signature Guidelines](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md#cmdlet-signature-guidelines)
+- [ ] New cmdlets that make changes or have side effects should implement `ShouldProcess` and have `SupportShouldProcess=true` specified in the cmdlet attribute. You can find more information on `ShouldProcess` [here](https://github.com/Azure/azure-powershell/wiki/PowerShell-Cmdlet-Design-Guidelines#supportsshouldprocess).
 - [ ] Cmdlet specifies `OutputType` attribute if any output is produced - if the cmdlet produces no output, it should implement a `PassThru` parameter.
 
-### [Cmdlet Parameter Guidelines](https://github.com/Azure/azure-powershell/blob/dev/CONTRIBUTING.md#cmdlet-parameter-guidelines)
+### [Cmdlet Parameter Guidelines](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md#cmdlet-parameter-guidelines)
 - [ ] Parameter types should not expose types from the management library - complex parameter types should be defined in the module.
 - [ ] Complex parameter types are discouraged - a parameter type should be simple types as often as possible. If complex types are used, they should be shallow and easily creatable from a constructor or another cmdlet.
 - [ ] Cmdlet parameter sets should be mutually exclusive - each parameter set must have at least one mandatory parameter not in other parameter sets.

ChangeLog.md

@@ -1,4 +1,80 @@
-## 2017.05.12 - Version 4.0.1
+## 2017.06.07 - Version 4.1.0
+* AnalysisServices
+    * New SKUs added: B1, B2, S0
+    * Scale up/down support added
+* CognitiveServices
+    * Update detailed display of license agreements when creating Cognitive Services resources
+* Compute
+    * Fix Test-AzureRmVMAEMExtension for virtual machines with multiple managed disks
+    * Updated Set-AzureRmVMAEMExtension: Add caching information for Premium managed disks
+    * Add-AzureRmVhd: The size limit on vhd is increased to 4TB.
+    * Stop-AzureRmVM: Clarify documentation for STayProvisioned parameter
+    * New-AzureRmDiskUpdateConfig
+      * Deprecated parameters CreateOption, StorageAccountId, ImageReference, SourceUri, SourceResourceId
+    * Set-AzureRmDiskUpdateImageReference: Deprecated cmdlet
+    * New-AzureRmSnapshotUpdateConfig
+      * Deprecated parameters CreateOption, StorageAccountId, ImageReference, SourceUri, SourceResourceId
+    * Set-AzureRmSnapshotUpdateImageReference: Deprecated Cmdlet
+* DataLakeStore
+    * Enable-AzureRmDataLakeStoreKeyVault (Enable-AdlStoreKeyVault)
+      * Enable KeyVault managed encryption for a DataLake Store
+* DevTestLabs
+    * Update cmdlets to work with current and updated DevTest Labs API version.
+* IotHub
+    * Add Routing support for IoTHub cmdlets
+* KeyVault
+  * New Cmdlets to support KeyVault Managed Storage Account Keys
+    * Get-AzureKeyVaultManagedStorageAccount
+    * Add-AzureKeyVaultManagedStorageAccount
+    * Remove-AzureKeyVaultManagedStorageAccount
+    * Update-AzureKeyVaultManagedStorageAccount
+    * Update-AzureKeyVaultManagedStorageAccountKey
+    * Get-AzureKeyVaultManagedStorageSasDefinition
+    * Set-AzureKeyVaultManagedStorageSasDefinition
+    * Remove-AzureKeyVaultManagedStorageSasDefinition
+* Network
+    * Get-AzureRmNetworkUsage: New cmdlet to show network usage and capacity details
+    * Added new GatewaySku options for VirtualNetworkGateways
+        * VpnGw1, VpnGw2, VpnGw3 are the new Skus added for Vpn gateways
+    * Set-AzureRmNetworkWatcherConfigFlowLog
+      * Fixed  help examples
+* NotificationHubs
+    * Transparent Update to NotificationHubs cmdlets for new API
+* Profile
+    * Resolve-AzureRmError
+      * New cmdlet to show details of errors and exceptions thrown by cmdlets, including server request/response data
+    * Send-Feedback
+      * Enabled sending feedback without logging in
+    * Get-AzureRmSubscription
+      * Fix bug in retreiving CSP subscriptions
+* Resources
+    * Fixed issue where Get-AzureRMRoleAssignment would result in a Bad Request if the number of roleassignments where greater than 1000
+        * Users can now use Get-AzureRMRoleAssignment even if the roleassignments to be returned is greater than 1000
+* Sql
+    * Restore-AzureRmSqlDatabase: Update documentation example
+* Storage
+    * Add AssignIdentity setting support to resource mode storage account cmdlets
+        * New-AzureRmStorageAccount
+        * Set-AzureRmStorageAccount
+    * Add Customer Key Support to resource mode storage account cmdlets
+        * Set-AzureRmStorageAccount
+        * New-AzureRmStorageAccountEncryptionKeySource
+* TrafficManager
+    
+    * New Monitor settings 'MonitorIntervalInSeconds', 'MonitorTimeoutInSeconds', 'MonitorToleratedNumberOfFailures'
+    * New Monitor protocol 'TCP'
+* ServiceManagement
+    * Add-AzureVhd: The size limit on vhd is increased to 4TB.
+    * New-AzureBGPPeering: Support LegacyMode
+* Azure.Storage
+    * Update help for parameters that accept wildcard characters and update StorageContext type
+
+## 2017.05.23 - Version 4.0.2
+* Profile
+    * Add-AzureRmAccount
+      * Added `-EnvironmentName` parameter alis for backward compatibility with 2.x versions of AzureRM.profile
+
+## 2017.05.12 - Version 4.0.1
  * Fix issue with New-AzureStorageContext in offline scenarios: https://github.com/Azure/azure-powershell/issues/3939
 
  ## 2017.05.10 - Version 4.0.0
@@ -3214,4 +3290,4 @@ Virtual Network cmdlets
  * iisnode 0.1.13
 
 2011.12.09 Version 0.5.0
- * Initial Release
+ * Initial Release

README.md

@@ -4,42 +4,56 @@
 
 This repository contains a set of PowerShell cmdlets for developers and administrators to develop, deploy and manage Microsoft Azure applications.
 
-* For documentation on how to build and deploy applications to Microsoft Azure please see the [Microsoft Azure Documentation Center](https://azure.microsoft.com/en-us/documentation/).
-* For comprehensive documentation on the developer cmdlets see [How to install and configure Azure PowerShell](https://azure.microsoft.com/en-us/documentation/articles/install-configure-powershell/).
-* For comprehensive documentation on the full set of Microsoft Azure cmdlets see [Microsoft Azure Management Center](http://go.microsoft.com/fwlink/?linkID=254459&clcid=0x409).
-* For suggesting improvements, join our improvement discussion ([#3692](https://github.com/Azure/azure-powershell/issues/3692)).
+* For documentation on how to build and deploy applications to Microsoft Azure please see the [Microsoft Azure Documentation Center](https://docs.microsoft.com/en-us/azure/).
+* For comprehensive documentation on the developer cmdlets see the [overview of Azure PowerShell](aka.ms/azpsdocs).
+* For suggesting improvements, join our improvement discussion ([Issue #3692](https://github.com/Azure/azure-powershell/issues/3692)).
 
 ## Features
 
 * Account management
   * Login with Microsoft account, Organizational account, or Service Principal through Microsoft Azure Active Directory
-  * Save Credentials to disk with Save-AzureRmProfile and load saved credentials using Select-AzureRmProfile
+  * Save Credentials to disk with Save-AzureRmContext and load saved credentials using Import-AzureRmContext
 * Environment
   * Get the different out-of-box Microsoft Azure environments
   * Add/Set/Remove customized environments (like your Azure Stack or Windows Azure Pack environments)
 * Management and data plane cmdlets for Azure services in ARM and RDFE
-  * VM
-  * Storage
-  * Network
+  * Virtual Machine
   * App Service (Websites)
   * SQL Database
-  * KeyVault
-  * Data Lake Store
-  * Data Lake Analytics
-  * Operational Insights
-  * Automation
-  * Batch
+  * Storage
   * Backup
-  * RecoveryServices and SiteRecovery
-  * Stream Analytics
-  * Traffic Manager
-  * DataFactories
-  * DNS
   * HDInsight
+  * Batch
+  * Container Registry
+  * StorSimple
+  * API Management
+  * IoT Hub
+  * Content Delivery Network (CDN)
   * Express Route
+  * RecoveryServices and SiteRecovery
+  * DNS
+  * Machine Learning
+  * Service Fabric
+  * Network
+  * Media Services
+  * Stream Analytics
+  * Event Hubs
+  * Data Factory
+  * Key Vault
+  * Service Bus
   * Scheduler
-  * StorSimple
+  * DevTest Labs
+  * Notification Hubs
+  * Automation
+  * Operational Insights
+  * Traffic Manager
   * Redis Cache
+  * Power BI Embedded
+  * Data Lake Store
+  * Data Lake Analytics
+  * Cognitive Services
+  * Logic Apps
+  * Analysis Services
 
 * Windows Azure Pack
   * Web Site: CRUD web site, deployment, configure and get log, start/stop/restart/show web site
@@ -53,9 +67,9 @@ This repository contains a set of PowerShell cmdlets for developers and administ
 
 
 For detail descriptions and examples of the cmdlets, type
-* ```help azure``` to get all the cmdlets.
-* ```help azurerm``` to get all the Azure Resource Manager (ARM) cmdlets.
-* ```help <cmdlet name>``` to get the details of a specific cmdlet.
+* ```Get-Help Azure``` to get all of the Azure PowerShell cmdlets.
+* ```Get-Help AzureRM``` to get all of the Azure Resource Manager (ARM) cmdlets.
+* ```Get-Help <cmdlet name>``` to get the details of a specific cmdlet.
 
 ## Supported Environments
 
@@ -67,42 +81,33 @@ For detail descriptions and examples of the cmdlets, type
 
 ## Installation
 
+### PowerShell Gallery
+1. Install [Windows Management Framework 5 with PowerShellGet cmdlets](https://msdn.microsoft.com/en-us/powershell/gallery/psgallery/psgallery_gettingstarted)
+2. In an elevated PowerShell session, run  ```Install-Module AzureRM```
+3. To install RDFE cmdlets, run ```Install-Module Azure```
+
 ### Microsoft Web Platform Installer
 
 1. Install [Microsoft Web Platform Installer](https://www.microsoft.com/web/downloads/platform.aspx).
 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](https://github.com/Azure/azure-powershell/releases)
-
-### PowerShell Gallery
-1. Install [Windows Management Framework 5 with PowerShellGet cmdlets](https://msdn.microsoft.com/en-us/powershell/gallery/psgallery/psgallery_gettingstarted)
-2. In an elevated PowerShell session, run  ```Install-Module AzureRM```
-3. Run ```Install-AzureRm```
-4. To install RDFE cmdlets, run ```Install-Module Azure```
-
-### Source Code
-
-1. Download the source code from GitHub repo
-2. Follow the [Azure PowerShell Developer Guide](https://github.com/Azure/azure-powershell/wiki/Azure-Powershell-Developer-Guide)
+You can also find the standalone installers for all versions of Azure PowerShell in the [releases section](https://github.com/Azure/azure-powershell/releases)
 
 ### Supported PowerShell Versions
 
-* [Windows Management Framework 3] (https://www.microsoft.com/en-us/download/details.aspx?id=34595)
-* [Windows Management Framework 4] (https://www.microsoft.com/en-us/download/details.aspx?id=40855)
-* [Windows Management Framework 5] (https://www.microsoft.com/en-us/download/details.aspx?id=50395)
+* [Windows Management Framework 3](https://www.microsoft.com/en-us/download/details.aspx?id=34595)
+* [Windows Management Framework 4](https://www.microsoft.com/en-us/download/details.aspx?id=40855)
+* [Windows Management Framework 5](https://www.microsoft.com/en-us/download/details.aspx?id=50395)
 
-## Get Started
+## Using Azure PowerShell
 
 In general, follow these steps to start using Microsoft Azure PowerShell
 
-* Get yourself authenticated with Microsoft Azure. For details, please check out [this article](https://docs.microsoft.com/powershell/azureps-cmdlets-docs/).
-  * Option 1: Login with your Microsoft account or Organizational account directly from PowerShell. Microsoft Azure Active Directory authentication is used in this case. No management certificate is needed.
-      * Starting from 1.0.0, you can use ```Add-AzureRmAccount -Credential``` to avoid the browser pop up for Organizational account.
-      * To use RDFE cmdlets, use ```Add-AzureAccount```
+* Get yourself authenticated with Microsoft Azure. For details, please check out [this article](https://docs.microsoft.com/en-us/powershell/azure/authenticate-azureps).
 * Use the cmdlets
 
-The first step can be different for different environment you are targeting. Following are detail instructions for each supported environment.
+The first step can be different for the possible environments you could be targeting. The following are detailed instructions for each supported environment.
 
 ### Microsoft Azure
 
@@ -111,10 +116,13 @@ If you use both mechanisms on the same subscription, Microsoft Azure Active Dire
 #### Login directly from PowerShell (Microsoft Azure Active Directory authentication)
 
 ```powershell
-# Pop up an embedded browser control for you to login
+# Interactive login - you will get a dialog box asking for your Azure credentials
 Add-AzureRmAccount
 
-# use the cmdlets to manage your services/applications
+# Non-interactive login - use service principals
+Add-AzureRmAccount -ServicePrincipal -ApplicationId "http://my-app" -Credential $pscredential -TenantId $tenantid
+
+# Use the cmdlets to manage your services/applications
 New-AzureRmResourceGroup -Name myresourceGroup -Location "West US"
 ```
 
@@ -123,7 +131,7 @@ New-AzureRmResourceGroup -Name myresourceGroup -Location "West US"
 ```powershell
 Add-AzureRmAccount -EnvironmentName AzureChinaCloud
 
-# use the cmdlets to manage your services/applications
+# Use the cmdlets to manage your services/applications
 New-AzureRmResourceGroup -Name myresourceGroup -Location "China East"
 ```
 
@@ -132,10 +140,19 @@ New-AzureRmResourceGroup -Name myresourceGroup -Location "China East"
 ```powershell
 Add-AzureRmAccount -EnvironmentName AzureUSGovernment
 
-# use the cmdlets to manage your services/applications
+# Use the cmdlets to manage your services/applications
 New-AzureRmResourceGroup -Name myresourceGroup -Location "US Gov Virginia"
 ```
 
+### Microsoft Azure Germany
+
+```powershell
+Add-AzureRmAccount -EnvironmentName AzureGermanCloud
+
+# Use the cmdlets to manage your services/applications
+New-AzureRmResourceGroup -Name myresourceGroup -Location "Germany Central"
+```
+
 ### Windows Azure Pack
 
 ```powershell
@@ -169,16 +186,17 @@ New-WAPackWebsite -Name mywebsite
 
 All the cmdlets can be put into 3 categories:
 
-1. ARM management cmdlets use the 'AzureRm' prefix (New-AzureRmResourceGroup, Get-AzureRmVM)
-2. Legacy RDFE management cmdlets use the 'Azure' prefix (Get-AzureVM)
-3. Data plane cmdlets that work in ARM or RDFE use the 'Azure' prefix (Get-AzureBlob)
+1. ARM management cmdlets use the `AzureRm` prefix (New-AzureRmResourceGroup, Get-AzureRmVM)
+2. Legacy RDFE management cmdlets use the `Azure` prefix (Get-AzureVM)
+3. Data plane cmdlets that work in ARM or RDFE use the `Azure` prefix (Get-AzureBlob)
 
 
 You can use the following cmdlet to find out all the cmdlets for your environment
 
 ```powershell
 # Return all the cmdlets for Azure Resource Manager (ARM)
 Get-Command *AzureRm*
+
 # Return all the cmdlets for Microsoft Azure
 Get-Command *Azure*
 
@@ -190,15 +208,15 @@ If you want to migrate some scripts from Microsoft Azure to Windows Azure Pack o
 
 ## Need Help?
 
-Be sure to check out the [Microsoft Azure Developer Forums on Stack Overflow](http://go.microsoft.com/fwlink/?LinkId=234489) if you have trouble with the provided code.
+Be sure to check out the [Azure Support Community](https://azure.microsoft.com/en-us/support/forums/) 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](https://azure.github.io/guidelines/).
 
-More information about contributing to this repo can be found in [CONTRIBUTING md](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md) and the [Documentation](https://github.com/Azure/azure-powershell/tree/preview/documentation) folder.
+More information about contributing to this repo can be found in [CONTRIBUTING md](https://github.com/Azure/azure-powershell/blob/preview/CONTRIBUTING.md) and the [Azure PowerShell Developer Guide](https://github.com/Azure/azure-powershell/wiki/Azure-Powershell-Developer-Guide) folder.
 
-If you encounter any bugs with the library please file an issue in the [Issues](https://github.com/Azure/azure-powershell/issues) section of the project.
+If you encounter any bugs with the library please file an issue in the [issues section](https://github.com/Azure/azure-powershell/issues) section of the project.
 
 # Learn More