Merge pull request Azure#4942 from Azure/release-5.0.0

Merge release-5.0.0 --> master

Author: cormacpayne

.gitattributes

@@ -5,4 +5,7 @@
 *.cs text eol=crlf
 *.csproj text eol=crlf
 *.ps1 text eol=crlf
+*.psd1 text eol=crlf
+*.psm1 text eol=crlf
+*.ps1xml text eol=crlf
 build.proj text eol=crlf

CONTRIBUTING.md

@@ -148,7 +148,9 @@ The following guidelines must be followed in **EVERY** pull request that is open
 
 The following guidelines must be followed in pull requests that add, edit, or remove a cmdlet.
 
-- Cmdlet name uses an approved PowerShell verb - use enums for `VerbsCommon`, `VerbsCommunication`, `VerbLifecycle`, `VerbsOther` whenever possible
+- Cmdlet name uses an approved PowerShell verb - use enums for `VerbsCommon`, `VerbsCommunication`, `VerbsData`, `VerbsDiagnostic`, `VerbsLifecycle`, `VerbsOther`, and `VerbsSecurity` whenever possible
+    - Note that you can see a list of all approved PowerShell verbs by running `Get-Verb` in PowerShell
+    - When a verb you would like to use is not in the list of approved verbs, or to get ideas on how to use verbs, consult the [Approved Verbs for Windows PowerShell Commands](https://msdn.microsoft.com/en-us/library/ms714428\(v=vs.85\).aspx) documentation where you will find descriptions of approved verbs as well as related verbs in the comments so that you can find one appropriate for your command
 - Cmdlet noun name uses the AzureRm prefix for management cmdlets, and the Azure prefix for data plane cmdlets
 - Cmdlet specifies the `OutputType` attribute if any output is produced; if the cmdlet produces no output, it should implement a `PassThrough` parameter
 - If the cmdlet makes changes or has side effects, it should implement `ShouldProcess` and have `SupportsShouldProcess = true` specified in the cmdlet attribute. See a discussion about correct `ShouldProcess` implementation [here](https://gist.github.com/markcowl/338e16fe5c8bbf195aff9f8af0db585d#what-is-the-change).

ChangeLog.md

@@ -1,4 +1,164 @@
-## 2017.10.12 - Version 4.4.1
+## 2017.11.8 - Version 5.0.0
+* NOTE: This is a breaking change release. Please see the migration guide (https://aka.ms/azps-migration-guide) for a full list of introduced breaking changes.
+* All cmdlets in AzureRM now support online help
+    - Run Get-Help with the -Online parameter to open the online help in your default Internet browser
+* AnalysisServices
+    * Fixed Synchronize-AzureAsInstance command to work with new AsAzure REST API for sync
+* ApiManagement
+    * Please see the migration guide for breaking changes made to ApiManagement this release
+    * Updated Cmdlet Get-AzureRmApiManagementUser to fix issue https://github.com/Azure/azure-powershell/issues/4510
+    * Updated Cmdlet New-AzureRmApiManagementApi to create Api with Empty Path https://github.com/Azure/azure-powershell/issues/4069
+* ApplicationInsights
+    * Add commands to get/create/remove applicaiton insights resource
+        - Get-AzureRmApplicationInsights 
+        - New-AzureRmApplicationInsights
+        - Remove-AzureRmApplicationInsights
+    * Add commands to get/update pricing/daily cap of applicaiton insights resource        
+        - Get-AzureRmApplicationInsights -IncludeDailyCap
+        - Set-AzureRmApplicationInsightsPricingPlan
+        - Set-AzureRmApplicationInsightsDailyCap
+    * Add commands to get/create/update/remove continuous export of applicaiton insights resource
+    	- Get-AzureRmApplicationInsightsContinuousExport
+    	- Set-AzureRmApplicationInsightsContinuousExport
+    	- New-AzureRmApplicationInsightsContinuousExport
+    	- Remove-AzureRmApplicationInsightsContinuousExport
+    * Add commands to get/create/remove api keys of applicaiton insights resoruce
+    	- Get-AzureRmApplicationInsightsApiKey
+    	- New-AzureRmApplicationInsightsApiKey
+    	- Remove-AzureRmApplicationInsightsApiKey
+* AzureBatch
+    * Added new parameters to `New-AzureRmBatchAccount`.
+        - `PoolAllocationMode`: The allocation mode to use for creating pools in the Batch account. To create a Batch account which allocates pool nodes in the user's subscription, set this to `UserSubscription`.
+        - `KeyVaultId`: The resource ID of the Azure key vault associated with the Batch account.
+        - `KeyVaultUrl`: The URL of the Azure key vault associated with the Batch account.
+    * Updated parameters to `New-AzureBatchTask`.
+        - Removed the `RunElevated` switch. The `UserIdentity` parameter has been added to replace `RunElevated`, and the equivalent behavior can be achieved by constructing a `PSUserIdentity` as shown below:
+            - $autoUser = New-Object Microsoft.Azure.Commands.Batch.Models.PSAutoUserSpecification -ArgumentList @("Task", "Admin")
+            - $userIdentity = New-Object Microsoft.Azure.Commands.Batch.Models.PSUserIdentity $autoUser
+        - Added the `AuthenticationTokenSettings` parameter. This parameter allows you to request the Batch service provide an authentication token to the task when it runs, avoiding the need to pass Batch account keys to the task in order to issue requests to the Batch service.
+        - Added the `ContainerSettings` parameter.
+            - This parameter allows you to request the Batch service run the task inside a container.
+        - Added the `OutputFiles` parameter.
+            - This parameter allows you to configure the task to upload files to Azure Storage after it has finished.
+    * Updated parameters to `New-AzureBatchPool`.
+        - Added the `UserAccounts` parameter.
+            - This parameter defines user accounts created on each node in the pool.
+        - Added `TargetLowPriorityComputeNodes` and renamed `TargetDedicated` to `TargetDedicatedComputeNodes`.
+            - A `TargetDedicated` alias was created for the `TargetDedicatedComputeNodes` parameter.
+        - Added the `NetworkConfiguration` parameter.
+            - This parameter allows you to configure the pools network settings.
+    * Updated parameters to `New-AzureBatchCertificate`.
+        - The `Password` parameter is now a `SecureString`.
+    * Updated parameters to `New-AzureBatchComputeNodeUser`.
+        - The `Password` parameter is now a `SecureString`.
+    * Updated parameters to `Set-AzureBatchComputeNodeUser`.
+        - The `Password` parameter is now a `SecureString`.
+    * Renamed the `Name` parameter to `Path` on `Get-AzureBatchNodeFile`, `Get-AzureBatchNodeFileContent`, and `Remove-AzureBatchNodeFile`.
+        - A `Name` alias was created for the `Path` parameter.
+    * Changes to objects
+        - Please see the Batch change log for the full list
+    * Added support for Azure Active Directory based authentication.
+        - To use Azure Active Directory authentication, retrieve a `BatchAccountContext` object using the `Get-AzureRmBatchAccount` cmdlet, and supply this `BatchAccountContext` to the `-BatchContext` parameter of a Batch service cmdlet. Azure Active Directory authentication is mandatory for accounts with `PoolAllocationMode = UserSubscription`.
+        - For existing accounts or for new accounts created with `PoolAllocationMode = BatchService`, you may continue to use shared key authentication by retrieving a `BatchAccountContext` object using the `Get-AzureRmBatchAccoutKeys` cmdlet.
+* Compute
+    * Azure Disk Encryption Extension Commands
+        - New Parameter for 'Set-AzureRmVmDiskEncryptionExtension': '-EncryptFormatAll' encrypt formats data disks
+        - New Parameters for 'Set-AzureRmVmDiskEncryptionExtension': '-ExtensionPublisherName' and '-ExtensionType' allow switching to other versions of the extension
+        - New Parameters for 'Disable-AzureRmVmDiskEncryption': '-ExtensionPublisherName' and '-ExtensionType' allow switching to other versions of the extension
+        - New Parameters for 'Get-AzureRmVmDiskEncryptionStatus': '-ExtensionPublisherName' and '-ExtensionType' allow switching to other versions of the extension
+* DataLakeAnalytics
+    * Please see the migration guide for breaking changes made to DataLakeAnalytics this release
+    * Changed one of the two OutputTypes of Get-AzureRmDataLakeAnalyticsAccount
+        - List\<DataLakeAnalyticsAccount> to List\<PSDataLakeAnalyticsAccountBasic>
+        - The properties of PSDataLakeAnalyticsAccountBasic is a strict subset of the properties of DataLakeAnalyticsAccount
+        - The additional properties that are in DataLakeAnalyticsAccount are not returned by the service.  Therefore, this change is to reflect this accurately. These additional properties are still in PSDataLakeAnalyticsAccountBasic, but they are tagged as Obsolete.
+    * Changed one of the two OutputTypes of Get-AzureRmDataLakeAnalyticsJob
+        - List\<JobInformation> to List\<PSJobInformationBasic>
+        - The properties of PSJobInformationBasic is a strict subset of the properties of JobInformation
+        - The additional properties that are in JobInformation are not returned by the service.  Therefore, this change is to reflect this accurately. These additional properties are still in PSJobInformationBasic, but they are tagged as Obsolete.
+* DataLakeStore
+    * Please see the migration guide for breaking changes made to DataLakeStore this release
+    * Changed one of the two OutputTypes of Get-AzureRmDataLakeStoreAccount
+        - List\<PSDataLakeStoreAccount> to List\<PSDataLakeStoreAccountBasic>
+        - The properties of PSDataLakeStoreAccountBasic is a strict subset of the properties of PSDataLakeStoreAccount
+        - The additional properties that are in PSDataLakeStoreAccount are not returned by the service.  Therefore, this change is to reflect this accurately. These additional properties are still in PSDataLakeStoreAccountBasic, but they are tagged as Obsolete.
+* Dns
+    * Support for CAA record types in Azure DNS
+       - Supports all operations on CAA record type
+* EventHub
+    * Please see the migration guide for breaking changes made to EventHub this release
+* Insights
+    * Please see the migration guide for breaking changes made to Insights this release
+* Network
+    * Please see the migration guide for breaking changes made to Network this release
+    * Added cmdlet to list available internet service providers for a specified Azure region
+        - Get-AzureRmNetworkWatcherReachabilityProvidersList
+    * Added cmdlet to get the relative latency score for internet service providers from a specified location to Azure regions
+        - Get-AzureRmNetworkWatcherReachabilityReport
+* Profile
+    - Set-AzureRmDefault
+        - Use this cmdlet to set a default resource group.  This will make the -ResourceGroup parameter optional for some cmdlets, and will use the default when a resource group is not specified
+        - ```Set-AzureRmDefault -ResourceGroupName "ExampleResourceGroup"```
+        - If resource group specified exists in the subscription, this resource group will be set to default.  Otherwise, the resource group will be created and then set to default.
+    - Get-AzureRmDefault
+        - Use this cmdlet to get the current default resource group (and other defaults in the future).
+        - ```Get-AzureRmDefault -ResourceGroup```
+    - Clear-AzureRmDefault
+        - Use this cmdlet to remove the current default resource group
+        - ```Clear-AzureRmDefault -ResourceGroup```
+    - Add-AzureRmEnvironment and Set-AzureRmEnvironment
+        - Add the BatchAudience parameter, which allows you to specify the Azure Batch Active Directory audience to use when acquiring authentication tokens for the Batch service.
+* RecoveryServices.Backup
+    * Added cmdlets to perform instant file recovery.
+        - Get-AzureRmRecoveryServicesBackupRPMountScript
+        - Disable-AzureRmRecoveryServicesBackupRPMountScript
+    * Updated RecoveryServices.Backup SDK version to the latest
+    * Updated tests for the Azure VM workload so that, all setups needed for test runs are done by the tests themselves.
+    * Fixes https://github.com/Azure/azure-powershell/issues/3164
+* RecoveryServices.SiteRecovery
+    * Changes for ASR VMware to Azure Site Recovery (cmdlets are currently supporting operations for Enterprise to Enterprise, Enterprise to Azure, HyperV to Azure)
+        - New-AzureRmRecoveryServicesAsrPolicy
+        - New-AzureRmRecoveryServicesAsrProtectedItem
+        - Update-AzureRmRecoveryServicesAsrPolicy
+        - Update-AzureRmRecoveryServicesAsrProtectionDirection
+    * Added support to AAD-based vault
+    * Added cmdlets to manage VCenter resources
+        - Get-AzureRmRecoveryServicesAsrVCenter
+        - New-AzureRmRecoveryServicesAsrVCenter
+        - Remove-AzureRmRecoveryServicesAsrVCenter
+        - Update-AzureRmRecoveryServicesAsrVCenter
+    * Added other cmdlets
+        - Get-AzureRmRecoveryServicesAsrAlertSetting
+        - Get-AzureRmRecoveryServicesAsrEvent
+        - New-AzureRmRecoveryServicesAsrProtectableItem
+        - Set-AzureRmRecoveryServicesAsrAlertSetting
+        - Start-AzureRmRecoveryServicesAsrResynchronizeReplicationJob
+        - Start-AzureRmRecoveryServicesAsrSwitchProcessServerJob
+        - Start-AzureRmRecoveryServicesAsrTestFailoverCleanupJob
+        - Update-AzureRmRecoveryServicesAsrMobilityService
+* ServiceBus
+    - Please see the migration guide for breaking changes made to ServiceBus this release
+* Sql
+    * Adding support for list and cancel the asynchronous updateslo operation on the database
+    	- update existing cmdlet Get-AzureRmSqlDatabaseActivity to return DB updateslo operation status.
+    	- add new cmdlet Stop-AzureRmSqlDatabaseActivity for cancel the asynchronous updateslo operation on the database.
+    * Adding support for Zone Redundancy for databases and elastic pools
+    	- Adding ZoneRedundant switch parameter to New-AzureRmSqlDatabase
+    	- Adding ZoneRedundant switch parameter to Set-AzureRmSqlDatabase
+    	- Adding ZoneRedundant switch parameter to New-AzureRmSqlElasticPool
+    	- Adding ZoneRedundant switch parameter to Set-AzureRmSqlElasticPool
+    * Adding support for Server DNS Aliases
+    	- Adding Get-AzureRmSqlServerDnsAlias cmdlet which gets server dns aliases by server and alias name or a list of server dns aliases for an azure Sql Server.
+    	- Adding New-AzureRmSqlServerDnsAlias cmdlet which creates new server dns alias for a given Azure Sql server
+    	- Adding Set-AzurermSqlServerDnsAlias cmlet which allows updating a Azure Sql Server to which server dns alias is pointing
+    	- Adding Remove-AzureRmSqlServerDnsAlias cmdlet which removes a server dns alias for a Azure Sql Server
+* Azure.Storage
+    * Upgrade to Azure Storage Client Library 8.5.0 and Azure Storage DataMovement Library 0.6.3
+    * Add File Share Snapshot Support Feature
+        - Add 'SnapshotTime' parameter to Get-AzureStorageShare
+        - Add 'IncludeAllSnapshot' parameter to Remove-AzureStorageShare
+
+## 2017.10.12 - Version 4.4.1
 * AzureBatch
      - Marked cmdlet parameters and type properties obsolete in 
        preparation for upcoming breaking change release (Version 4.0.0)

README.md

@@ -8,6 +8,17 @@ This repository contains a set of PowerShell cmdlets for developers and administ
 * For comprehensive documentation on the developer cmdlets see the [overview of Azure PowerShell](https://aka.ms/azpsdocs).
 * For suggesting improvements, join our improvement discussion ([Issue #3692](https://github.com/Azure/azure-powershell/issues/3692)).
 
+## Modules
+
+Below is a table containing the various Azure PowerShell rollup modules found in this repository. For a full list of modules found in this repository, please see the [Azure PowerShell Modules](documentation/azure-powershell-modules.md) page.
+
+| Description                                                     | Module Name       | PowerShell Gallery Link |
+| --------------------------------------------------------------- | ----------------- | ----------------------- |
+| Rollup Module for ARM Cmdlets                                   | `AzureRM`         | [![AzureRM](https://img.shields.io/powershellgallery/v/AzureRM.svg?style=flat-square&label=AzureRM)](https://www.powershellgallery.com/packages/AzureRM/) |
+| Rollup Module for .NET Core Cmdlets                             | `AzureRM.Netcore` | [![AzureRM.Netcore](https://img.shields.io/powershellgallery/v/AzureRM.Netcore.svg?style=flat-square&label=AzureRM.Netcore)](https://www.powershellgallery.com/packages/AzureRM.Netcore/) |
+| Rollup Module for Administrative Modules in Azure Stack         | `AzureStack`      | [![AzureStack](https://img.shields.io/powershellgallery/v/AzureStack.svg?style=flat-square&label=AzureStack)](https://www.powershellgallery.com/packages/AzureStack/) |
+| Rolledup Module for Service Management Cmdlets                  | `Azure`           | [![Azure](https://img.shields.io/powershellgallery/v/Azure.svg?style=flat-square&label=Azure)](https://www.powershellgallery.com/packages/Azure/) |
+
 ## Features
 
 * Account management

TestMappings.json

@@ -173,5 +173,8 @@
   ],
   "src/ResourceManager/MarketplaceOrdering/Commands.MarketplaceOrdering.Test/": [
     ".\\src\\ResourceManager\\MarketplaceOrdering\\Commands.MarketplaceOrdering.Test\\bin\\Debug\\Microsoft.Azure.Commands.MarketplaceOrdering.Test.dll"
-  ]
+  ],
+ "src/ResourceManager/ApplicationInsights/": [
+    ".\\src\\ResourceManager\\ApplicationInsights\\Commands.ApplicationInsights.Test\\bin\\Debug\\Microsoft.Azure.Commands.ApplicationInsights.Test.dll"
+  ]  
 }

appveyor.yml

@@ -1,3 +1,4 @@
+clone_folder: c:\ps
 branches:
   only:
     - master
@@ -7,6 +8,11 @@ environment:
     secure: VMFbecLLHzDq/09YDPbcM0VDDSwwgY57vr5GXK6cZZ4Ti/Xs5RZoylzV8MMr1350
 
 before_build:
+  - ps: Install-Module -Name SplitPipeline -Force
+  - ps: Install-Module -Name platyPS -Force
+  - ps: Install-Module -Name Azure -Force
+  - ps: Install-Module -Name AzureRM -Force
+  - ps: Install-Module -Name AzureStack -Force
   - ps: Install-Product node $env:nodejs_version
   - git config --global credential.helper store
   - ps: ac "$env:USERPROFILE\.git-credentials" "https://$($env:github_access_token):[email protected]`n"
@@ -25,6 +31,6 @@ test: off
 on_success:
   - git clone -q --branch=%target_branch% %content_repo% %TEMP%\Azure
   - cd %TEMP%\Azure
-  - ps: ls c:\projects\_output -dir | % { copy $_.FullName (ls -dir | select -First 1) -Recurse -Force }
+  - ps: ls c:\projects\_output -dir | % { copy $_.FullName . -Recurse -Force }
   - git add -A
   - git diff --quiet --exit-code --cached || git commit -m "Sync docs from source code repo to content repo." && git push origin %target_branch% && appveyor AddMessage "Content Updated"