Merge pull request Azure#3035 from Azure/release-3.0.0

Merge release-3.0.0 -> master

Author: markcowl

AzurePowershell.Test.targets

@@ -96,9 +96,7 @@
       <XUnitTests Include=".\src\ResourceManager\PowerBIEmbedded\Commands.PowerBIEmbedded.Test\bin\Debug\Microsoft.Azure.Commands.PowerBIEmbedded.Test.dll"/>
       <XUnitTests Include=".\src\ResourceManager\DataLakeAnalytics\Commands.DataLakeAnalytics.Test\bin\Debug\Microsoft.Azure.Commands.DataLakeAnalytics.Test.dll"/>
       <XUnitTests Include=".\src\ResourceManager\DataLakeStore\Commands.DataLakeStore.Test\bin\Debug\Microsoft.Azure.Commands.DataLake.Test.dll"/>
-      <!-- <XUnitTests Include=".\src\ResourceManager\AzureStackAdmin\Commands.AzureStackAdmin.Test\bin\Debug\Microsoft.AzureStack.Commands.Admin.Test.dll"/>
-      <XUnitTests Include=".\src\ResourceManager\AzureStackStorage\Commands.AzureStackStorage.Tests\bin\Debug\Microsoft.AzureStack.Commands.StorageAdmin.Test.dll"/>
-      <XUnitTests Include=".\src\ResourceManager\DevTestLabs\Commands.DevTestLabs.Test\bin\Debug\Microsoft.Azure.Commands.DevTestLabs.Test.dll"/> 
+      <!-- <XUnitTests Include=".\src\ResourceManager\DevTestLabs\Commands.DevTestLabs.Test\bin\Debug\Microsoft.Azure.Commands.DevTestLabs.Test.dll"/> 
       <XUnitTests Include=".\src\ResourceManager\HDInsight\Commands.HDInsight.Test\bin\Debug\Commands.HDInsight.Test.dll"/>
       <XUnitTests Include=".\src\ResourceManager\Insights\Commands.Insights.Test\bin\Debug\Microsoft.Azure.Commands.Insights.Test.dll"/> -->
       <XUnitTests Include=".\src\ResourceManager\RecoveryServices\Commands.RecoveryServices.Test\bin\Debug\Microsoft.Azure.Commands.RecoveryServicesArm.Test.dll"/>

ChangeLog.md

@@ -1,4 +1,74 @@
-## 2016.09.16 version 2.2.0
+## 2016.09.28 version 3.0.0
+* This release contains breaking changes. Please see [the migration guide](documentation/release-notes/migration-guide.3.0.0.md) for change details and the impact on existing scripts.
+* ApiManagement
+    * Enable support of Importing and Exporting SOAP based APIs (Wsdl Format)
+        - Import-AzureRmApiManagementApi
+        - Export-AzureRmApiManagementApi
+    * Deprecated cmdlet Set-AzureRmApiManagementVirtualNetworks. In place, place used cmdlet Update-AzureRmApiManagementDeployment
+    * Enabled support for ARM based VNETs for configuration Vpn via cmdlet Update-AzureRmApiManagementDeployment
+    * Introduced support for VpnType (None, External, Internal) to differentiate ApiManagement workloads for Internet and Intranet
+    * Fixed PowerShell issues
+        - https://github.com/Azure/azure-powershell/issues/2622
+        - https://github.com/Azure/azure-powershell/issues/2606
+* Batch
+    * Added new cmdlet for reactivating tasks
+        - Enable-AzureBatchTask
+    * Added new parameter for application packages on job manager tasks and cloud tasks
+        - New-AzureBatchTask -ApplicationPackageReferences
+    * Added new parameters for job auto termination
+        - New-AzureBatchJob -OnAllTasksComplete -OnTaskFailure
+        - New-AzureBatchJob -ExitConditions
+* ExpressRoute
+    * Added new parameter service key in return object when provider list all cross connection
+        - Get-AzureCrossConnectionCommand
+* MachineLearning
+    * Get-AzureRmMlWebService supports paginated response
+    * Remind user Get-AzureRmMlWebService "Name" parameter needs to work with "ResourceGroupName" parameter
+* Network
+    * Added new cmdlet to get application gateway backend health
+        - Get-AzureRmApplicationGatewayBackendHealth
+    * Added support for creating UltraPerformance sku
+        - New-AzureRmVirtualNetworkGateway -GatewaySku
+        - New-AzureVirtualNetworkGateway -GatewaySku   
+* RemoteApp
+    * Added cmdlets to enable User Disk and Gold Image Migration feature
+        - Export-AzureRemoteAppUserDisk
+        - Export-AzureRemoteAppTemplateImage
+* SiteRecovery
+    * New cmdlets have been added to support one to one mapping with service objects.
+        - Get-AzureRmSiteRecoveryFabric
+        - Get-AzureRmSiteRecoveryProtectableItem
+        - Get-AzureRmSiteRecoveryProtectionContainerMapping
+        - Get-AzureRmSiteRecoveryRecoveryPoin
+        - Get-AzureRmSiteRecoveryReplicationProtectedItem
+        - Get-AzureRmSiteRecoveryServicesProvider
+        - New-AzureRmSiteRecoveryFabri
+        - New-AzureRmSiteRecoveryProtectionContainerMapping
+        - New-AzureRmSiteRecoveryReplicationProtectedItem
+        - Remove-AzureRmSiteRecoveryFabric
+        - Remove-AzureRmSiteRecoveryProtectionContainerMapping
+        - Remove-AzureRmSiteRecoveryReplicationProtectedItem
+        - Remove-AzureRmSiteRecoveryServicesProvider
+        - Set-AzureRmSiteRecoveryReplicationProtectedItem
+        - Start-AzureRmSiteRecoveryApplyRecoveryPoint
+        - Update-AzureRmSiteRecoveryServicesProvider
+    * Following cmdlets have been modified for to support one to one mapping with service objects.
+        - Edit-AzureRmSiteRecoveryRecoveryPlan
+        - Get-AzureRmSiteRecoveryNetwork
+        - Get-AzureRmSiteRecoveryNetworkMapping
+        - Get-AzureRmSiteRecoveryProtectionContainer
+        - Get-AzureRmSiteRecoveryStorageClassification
+        - Get-AzureRmSiteRecoveryStorageClassificationMapping
+        - Start-AzureRmSiteRecoveryCommitFailoverJob
+        - Start-AzureRmSiteRecoveryPlannedFailoverJob
+        - Start-AzureRmSiteRecoveryTestFailoverJob
+        - Start-AzureRmSiteRecoveryUnplannedFailoverJob
+        - Update-AzureRmSiteRecoveryProtectionDirection
+        - Update-AzureRmSiteRecoveryRecoveryPlan  
+    * HUB support added to Set-AzureRmSiteRecoveryReplicationProtectedItem.
+    * Deprecation warning introduced for cmlets/parameter-sets which does not comply to SiteRecovery service object model.
+
+## 2016.09.16 version 2.2.0
 * Network
   - New switch parameter added for network interface to enable/Disable accelerated networking -New-AzureRmNetworkInterface -EnableAcceleratedNetworking
 

build.proj

@@ -58,6 +58,11 @@
     <StaticAnalysis Include=".\tools\StaticAnalysis\StaticAnalysis.sln" />
   </ItemGroup>
 
+  <!-- Tasks -->
+  <UsingTask TaskName="ValidateStrongNameSignatureTask" AssemblyFile="$(LibraryToolsFolder)\Microsoft.Azure.Build.Tasks.dll"  />
+  <UsingTask TaskName="FilterOutAutoRestLibraries" AssemblyFile="$(LibraryToolsFolder)\Microsoft.Azure.Build.Tasks.dll"  />
+  <UsingTask TaskName="DebugTask" AssemblyFile="$(LibraryToolsFolder)\Microsoft.Azure.Build.Tasks.dll"  />
+  
   <!--
   CI build related
   -->
@@ -143,7 +148,7 @@
     <Exec Command="$(NuGetCommand) restore %(CmdletSolutionsToBuild.FullPath) $(NuGetRestoreConfigSwitch) $(NuGetRestorePackageSetting)" 
           ContinueOnError="false" />
     <!-- Restore packages for static analysis-->
-    <Exec Command="$(NuGetCommand) restore %(StaticAnalysis.FullPath) $(NuGetRestoreConfigSwitch)"
+    <Exec Command="$(NuGetCommand) restore %(StaticAnalysis.FullPath) $(NuGetRestoreConfigSwitch) $(NuGetRestorePackageSetting)"
           ContinueOnError="false" />
 
     <!--Restore the xunit runner needed to run unit tests-->
@@ -161,7 +166,7 @@
       Properties="Configuration=$(Configuration);Platform=Any CPU"
       BuildInParallel="$(BuildInParallel)" 
       ContinueOnError="false" />
-      
+    
     <CallTarget Targets="CodeSignBinaries" Condition=" '$(CodeSign)' == 'true' " />
 
     <MSBuild
@@ -193,9 +198,6 @@
              Targets="Build" Properties="Configuration=Debug;Platform=AnyCPU" />
   </Target>
 
-  <UsingTask TaskName="ValidateStrongNameSignatureTask" AssemblyFile="$(LibraryToolsFolder)\Microsoft.Azure.Build.Tasks.dll"  />
-  <UsingTask TaskName="FilterOutAutoRestLibraries" AssemblyFile="$(LibraryToolsFolder)\Microsoft.Azure.Build.Tasks.dll"  />  
-  
   <Target Name="CodeSignBinaries">
     <PropertyGroup>
       <!--public token associated with MSSharedLibKey.snk-->
@@ -221,7 +223,7 @@
 
     <Message Importance="high" Text="$(LibrarySourceFolder)\Package\$(Configuration) does not contains any files to sign. Code sign will skip." 
              Condition="'@(DelaySignedAssembliesToSign)' == ''" />
-             
+
     <ValidateStrongNameSignatureTask
       WindowsSdkPath="$(WindowsSdkPath)"
       Assembly="%(DelaySignedAssembliesToSign.Identity)"
@@ -259,7 +261,7 @@
         ExpectedDelaySigned="false"
         ContinueOnError="false" 
         Condition="!$(DelaySign) and '@(DelaySignedAssembliesToSign)' != ''"/>
-    
+	
     <Exec Command="$(PowerShellCommand) -NonInteractive -NoLogo -NoProfile -Command &quot;. $(LibraryToolsFolder)\CheckStrongNameSignature.ps1 &quot;"/>
 
     <!-- Copying signed shortcut back -->

documentation/release-notes/migration-guide.3.0.0.md

@@ -0,0 +1,117 @@
+# Breaking changes for Microsoft Azure PowerShell 3.0.0.
+
+This document serves as both a breaking change notification and migration guide for consumers of the Microsoft Azure PowerShell cmdlets.  Each section describes both the impetus for the breaking change and the migration path of least resistance.  For in-depth context, please refer to the pull request associated with each change.
+
+## Table of Contents
+1. [Breaking changes to Data Lake Store cmdlets](#breaking-changes-to-data-lake-store-cmdlets)
+2. [Breaking changes to ApiManagement cmdlets](#breaking-changes-to-apimanagement-cmdlets)
+3. [Breaking changes to Network cmdlets](#breaking-changes-to-network-cmdlets)
+
+## Breaking changes to Data Lake Store cmdlets
+
+The following cmdlets were affected this release ([PR 2965](https://github.com/Azure/azure-powershell/pull/2965)):
+
+**Get-AzureRmDataLakeStoreItemAcl (Get-AdlStoreItemAcl)**
+- This cmdlet was removed and replaced with ``Get-AzureRmDataLakeStoreItemAclEntry (Get-AdlStoreItemAclEntry)``.
+- The old cmdlet returned a complex object representing the access control list (ACL). The new cmdlet returns a simple list of entries in the chosen path's ACL.
+
+```powershell
+# Old
+Get-AdlStoreItemAcl -Account myadlsaccount -Path /foo
+
+# New
+Get-AdlStoreItemAclEntry -Account myadlsaccount -Path /foo
+```
+
+**Get-AzureRmDataLakeStoreItemAclEntry (Get-AdlStoreItemAclEntry)**
+- This cmdlet replaces the old cmdlet ``Get-AzureRmDataLakeStoreItemAcl (Get-AdlStoreItemAcl)``.
+- This new cmdlet returns a simple list of entries in the chosen path's ACL, with type ``DataLakeStoreItemAce[]``.
+- The output of this cmdlet can be passed in to the ``-Acl`` parameter of the following cmdlets:
+   - ``Remove-AzureRmDataLakeStoreItemAcl``
+   - ``Set-AzureRmDataLakeStoreItemAcl``
+   - ``Set-AzureRmDataLakeStoreItemAclEntry``
+
+```powershell
+# Old
+Get-AdlStoreItemAcl -Account myadlsaccount -Path /foo
+
+# New
+Get-AdlStoreItemAclEntry -Account myadlsaccount -Path /foo
+```
+
+**Remove-AzureRmDataLakeStoreItemAcl (Remove-AdlStoreItemAcl)**, **Set-AzureRmDataLakeStoreItemAcl (Set-AdlStoreItemAcl)**, **Set-AzureRmDataLakeStoreItemAclEntry (Set-AdlStoreItemAclEntry)**
+- These cmdlets now accept ``DataLakeStoreItemAce[]`` for the ``-Acl`` parameter.
+- ``DataLakeStoreItemAce[]`` is returned by ``Get-AzureRmDataLakeStoreItemAclEntry (Get-AdlStoreItemAclEntry)``.
+
+```powershell
+# Old
+$acl = Get-AdlStoreItemAcl -Account myadlsaccount -Path /foo
+Set-AdlStoreItemAcl -Account myadlsaccount -Path /foo -Acl $acl
+
+# New
+$aclEntries = Get-AdlStoreItemAclEntry -Account myadlsaccount -Path /foo
+Set-AdlStoreItemAcl -Account myadlsaccount -Path /foo -Acl $aclEntries
+```
+
+## Breaking changes to ApiManagement cmdlets
+
+The following cmdlets were affected this release ([PR 2971](https://github.com/Azure/azure-powershell/pull/2971)):
+
+**New-AzureRmApiManagementVirtualNetwork**
+- The required parameters to reference a virtual network changed from requiring SubnetName and VnetId to SubnetResourceId in format 
+``/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ClassicNetwork/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}``
+
+```powershell
+# Old
+$virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location <String> -SubnetName <String> -VnetId <Guid>
+
+# New
+$virtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location <String> -SubnetResourceId <String>
+
+```
+
+**Deprecating Cmdlet Set-AzureRmApiManagementVirtualNetworks**
+- The Cmdlet is getting deprecated as there was more than one way to Set Virtual Network associated to ApiManagement deployment.
+
+```powershell
+# Old
+$networksList = @()
+$networksList += New-AzureRmApiManagementVirtualNetwork -Location $vnetLocation -VnetId $vnetId -SubnetName $subnetName
+Set-AzureRmApiManagementVirtualNetworks -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetworks $networksList
+
+# New
+$masterRegionVirtualNetwork = New-AzureRmApiManagementVirtualNetwork -Location <String> -SubnetResourceId <String>
+Update-AzureRmApiManagementDeployment -ResourceGroupName "ContosoGroup" -Name "ContosoApi" -VirtualNetwork $masterRegionVirtualNetwork
+```
+
+## Breaking changes to Network cmdlets
+
+The following cmdlets were affected this release ([PR 2982](https://github.com/Azure/azure-powershell/pull/2982)):
+
+**New-AzureRmVirtualNetworkGateway**
+- Description of what has changed ``:- Bool parameter:-ActiveActive`` is removed and ``SwitchParameter:-EnableActiveActiveFeature`` is added for enabling Active-Active feature on newly creating virtual network gateway.
+
+```powershell
+# Old 
+# Sample of how the cmdlet was previously called
+New-AzureRmVirtualNetworkGateway -ResourceGroupName $rgname -name $rname -Location $location -IpConfigurations $vnetIpConfig1,$vnetIpConfig2 -GatewayType Vpn -VpnType RouteBased -EnableBgp $false -GatewaySku HighPerformance -ActiveActive $true
+
+# New
+# Sample of how the cmdlet should now be called
+New-AzureRmVirtualNetworkGateway -ResourceGroupName $rgname -name $rname -Location $location -IpConfigurations $vnetIpConfig1,$vnetIpConfig2 -GatewayType Vpn -VpnType RouteBased -EnableBgp $false -GatewaySku HighPerformance -EnableActiveActiveFeature
+```
+
+Set-AzureRmVirtualNetworkGateway
+- Description of what has changed ``:- Bool parameter:-ActiveActive`` is removed and 2 ``SwitchParameters:-EnableActiveActiveFeature`` / ``DisableActiveActiveFeature`` are added for enabling and disabling Active-Active feature on virtual network gateway.
+
+```powershell
+# Old
+# Sample of how the cmdlet was previously called
+Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $gw -ActiveActive $true
+Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $gw -ActiveActive $false  
+
+# New
+# Sample of how the cmdlet should now be called
+Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $gw -EnableActiveActiveFeature
+Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $gw -DisableActiveActiveFeature
+```

setup/azurecmd.wxs

@@ -5,7 +5,7 @@
   <?define sourceDir="$(var.SolutionDir)..\src\Package\$(var.Configuration)" ?>
   <?define caSourceDir="$(var.SolutionDir)setup\bin\$(var.Configuration)" ?>
 
-  <?define version="2.1.0" ?>
+  <?define version="3.0.0" ?>
 
   <Product Id="*"
            Name="$(var.productName)"