Azure PowerShell v4.1.0 Release Notes

Release Date: 2020-05-01 // about 4 years ago
  • ๐Ÿš€ Highlights since the last release

    • ๐Ÿ‘Œ Supported PowerShell versions: Windows PowerShell 5.1, PowerShell Core 6.2.4+, PowerShell 7
    • General availability of Az.Functions
    • ๐Ÿš€ Az.ApiManagement, Az.Batch, Az.Compute, Az.KeyVault, Az.Monitor, Az.Network, Az.OperationalInsights, Az.Resources, and Az.Storage have major release

    Az.Accounts

    • โšก๏ธ Updated 'Add-AzEnvironment' and 'Set-AzEnvironment' to accept parameters 'AzureSynapseAnalyticsEndpointResourceId' and 'AzureSynapseAnalyticsEndpointSuffix'
    • โž• Added Azure.Core related assemblies into Az.Accounts, supported PowerShell platforms include Windows PowerShell 5.1, PowerShell Core 6.2.4, PowerShell 7+

    Az.Aks

    • โฌ†๏ธ Upgraded API Version to 2019-10-01
    • ๐Ÿ‘Œ Supported to create AKS using Windows container
    • โšก๏ธ Provided new cmdlets: 'New-AzAksNodePool', 'Update-AzAksNodePool', 'Remove-AzAksNodePool', 'Get-AzAksNodePool', 'Install-AzAksKubectl', 'Get-AzAksVersion'

    Az.ApiManagement

    • 'New-AzApiManagement' and 'Set-AzApiManagement': [-AssignIdentity] parameter renamed as [-SystemAssignedIdentity]
    • 'New-AzApiManagement' and 'Set-AzApiManagement': New parameter added: [-UserAssignedIdentity ]
    • 'Get-AzApiManagementProperty': renamed as 'Get-AzApiManagementNamedValue'. PropertyId parameter renamed as NamedValueId.
    • 'New-AzApiManagementProperty': renamed as 'New-AzApiManagementNamedValue'. PropertyId parameter renamed as NamedValueId.
    • 'Set-AzApiManagementProperty': renamed as 'Set-AzApiManagementNamedValue'. PropertyId parameter renamed as NamedValueId.
    • ๐Ÿšš 'Remove-AzApiManagementProperty': renamed as 'Remove-AzApiManagementNamedValue'. PropertyId parameter renamed as NamedValueId.
    • โž• Added new 'Get-AzApiManagementAuthorizationServerClientSecret' cmdlet and 'Get-AzApiManagementAuthorizationServer' will not return client secret anymore.
    • โž• Added new 'Get-AzApiManagementNamedValueSecretValue' cmdlet and 'Get-AzApiManagementNamedValue' will not return secret value.
    • โž• Added new 'Get-AzApiManagementOpenIdConnectProviderClientSecret' cmdlet and 'Get-AzApiManagementOpenIdConnectProvider' will not return client secret anymore.
    • โž• Added new 'Get-AzApiManagementSubscriptionKey' cmdlet and 'Get-AzApiManagementSubscription' will not return subscription keys anymore.
    • โž• Added new 'Get-AzApiManagementTenantAccessSecret' cmdlet and 'Get-AzApiManagementTenantAccess' will not return keys anymore.
    • โž• Added new 'Get-AzApiManagementTenantGitAccessSecret' cmdlet and 'Get-AzApiManagementTenantGitAccess' will not return keys anymore.

    Az.ApplicationInsights

    • โž• Added Parameters: 'RetentionInDays' 'PublicNetworkAccessForIngestion' 'PublicNetworkAccessForQuery' for 'New-AzApplicationInsights'
    • โšก๏ธ Created cmdlet 'Update-AzApplicationInsights'
    • Created cmdlets for Linked Storage Account

    Az.Batch

    • โšก๏ธ Updated Az.Batch to use 'Microsoft.Azure.Batch' SDK version 13.0.0 and 'Microsoft.Azure.Management.Batch' SDK version 9.0.0.
    • โž• Added the ability to select the kind of certificate being added using the new '-CertificateKind' parameter to 'New-AzBatchCertificate'.
    • โœ‚ Removed 'ApplicationPackages' property from 'PSApplication' which was previously always ''.
      • The specific packages inside of an application now can be retrieved using 'Get-AzBatchApplicationPackage'. For example: 'Get-AzBatchApplication -AccountName myaccount -ResourceGroupName myresourcegroup -ApplicationId myapplication'.
    • When creating a pool using 'New-AzBatchPool', the 'VirtualMachineImageId' property of 'PSImageReference' can now only refer to a Shared Image Gallery image.
    • When creating a pool using 'New-AzBatchPool', the pool can be provisioned without a public IP using the new 'PublicIPAddressConfiguration' property of 'PSNetworkConfiguration'.
      • The 'PublicIPs' property of 'PSNetworkConfiguration' has moved in to 'PSPublicIPAddressConfiguration' as well. This property can only be specified if 'IPAddressProvisioningType' is 'UserManaged'.

    Az.Compute

    • โž• Added HostId parameter to 'Update-AzVM' cmdlet
    • โšก๏ธ Updated Help documents for 'New-AzVMConfig', 'New-AzVmssConfig', 'Update-AzVmss', 'Set-AzVMOperatingSystem' and 'Set-AzVmssOsProfile' cmdlets.
    • ๐Ÿ’ฅ Breaking changes
      • FilterExpression parameter is removed from 'Get-AzVMImage' cmdlet.
      • AssignIdentity parameter is removed from 'New-AzVmssConfig', 'New-AzVMConfig' and 'Update-AzVM' cmdlets.
      • AutomaticRepairMaxInstanceRepairsPercent is removed from 'New-AzVmssConfig' and 'Update-AzVmss' cmdlets.
      • AvailabilitySetsColocationStatus, VirtualMachinesColocationStatus and VirtualMachineScaleSetsColocationStatus properties are removed from ProximityPlacementGroup.
      • MaxInstanceRepairsPercent property is removed from AutomaticRepairsPolicy.
      • The types of AvailabilitySets, VirtualMachines and VirtualMachineScaleSets are changed from IList to IList.
    • โšก๏ธ Description for 'Get-AzVM' cmdlet has been updated to better describe it.

    Az.DataFactory

    • ๐Ÿ‘Œ Supported CRUD of data flow runtime properties in Managed IR.

    Az.FrontDoor

    • โž• Added new cmdlets for creation, update, retreival, and deletion of Front Door Rules Engine object
    • โž• Added helper cmdlets for construction of Front Door Rules Engine object
    • โž• Added Rules Engine reference to Front Door Routing Rule object.
    • โž• Added Private Link parameters to Front Door Backend object

    Az.Functions

    • General availability of ''Az.Functions'' module

    Az.HDInsight

    • ๐Ÿ‘Œ Supported Customer-managed key disk encryption.

    Az.HealthcareApis

    • 0๏ธโƒฃ Access policies are no longer defaulted to the current principal

    Az.IotHub

    • โž• Added cmdlet to invoke a query in an IoT hub to retrieve information using a SQL-like language.
    • ๐Ÿ›  Fix issue that 'Add-AzIotHubDevice' fails to create Edge Enabled Device without child devices [#11597]
    • โž• Added cmdlet to generate SAS token for Iot Hub, device or module.
    • โž• Added cmdlet to invoke configuration metrics query.
    • ๐Ÿš€ Manage IoT Edge automatic deployment at scale. New cmdlets are:
      • 'Add-AzIotHubDeployment'
      • 'Get-AzIotHubDeployment'
      • 'Remove-AzIotHubDeployment'
      • 'Set-AzIotHubDeployment'
    • โž• Added cmdlet to invoke an IoT Edge deployment metrics query.
    • โž• Added cmdlet to apply the configuration content to the specified edge device.

    Az.KeyVault

    • โœ‚ Removed two aliases: 'New-AzKeyVaultCertificateAdministratorDetails' and 'New-AzKeyVaultCertificateOrganizationDetails'
    • 0๏ธโƒฃ Enabled soft delete by default when creating a key vault
    • Network rules can be set to govern the accessibility from specific network locations when creating a key vault
    • โž• Added support to bring your own key (BYOK)
      • 'Add-AzKeyVaultKey' supports generating a key exchange key
      • 'Get-AzKeyVaultKey' supports downloading a public key in PEM format
    • โšก๏ธ Updated the 'KeyOps' part of the help document of 'Add-AzKeyVaultKey'

    Az.Monitor

    • ๐Ÿ›  Fixed bug for 'Set-AzDiagnosticSettings', retention policy won't apply to all categories [#11589]
    • ๐Ÿ‘Œ Supported WebTest availability criteria for metric alert V2
      • 'New-AzMetricAlertRuleV2Criteria': an option to create webtest availability criteria was added
      • 'Add-AzMetricAlertRuleV2': supports the new webtest availability criteria
    • โœ‚ Removed redundant definition for RetentionPolicy in PSLogProfile [#7608]
    • โœ‚ Removed redundant properties difined in PSEventData [#11353]
    • ๐Ÿ“‡ Renamed 'Get-AzLog' to 'Get-AzActivityLog'

    Az.Network

    • โž• Added breaking change attribute to notify that Zone default behaviour will be changed
      • 'New-AzPublicIpAddress'
      • 'New-AzPublicIpPrefix'
      • 'New-AzLoadBalancerFrontendIpConfig'
    • โž• Added support for a new top level resource SecurityPartnerProvider
      • New cmdlets added:
        • New-AzSecurityPartnerProvider
        • Remove-AzSecurityPartnerProvider
        • Get-AzSecurityPartnerProvider
        • Set-AzSecurityPartnerProvider
    • โž• Added 'RequiredZoneNames' on 'PSPrivateLinkResource' and 'GroupId' on 'PSPrivateEndpointConnection'
    • ๐Ÿ›  Fixed incorrect type of SuccessThresholdRoundTripTimeMs parameter for New-AzNetworkWatcherConnectionMonitorTestConfigurationObject
    • โšก๏ธ Updated VirtualWan cmdlets to set default value of AllowVnetToVnetTraffic argument to True.
      • 'New-AzVirtualWan'
      • 'Update-AzVirtualWan'
    • โž• Added new cmdlets to support DNS zone group for private endpoint
      • 'New-AzPrivateDnsZoneConfig'
      • 'Get-AzPrivateDnsZoneGroup'
      • 'New-AzPrivateDnsZoneGroup'
      • 'Set-AzPrivateDnsZoneGroup'
      • 'Remove-AzPrivateDnsZoneGroup'
    • โž• Added 'DNSEnableProxy', 'DNSRequireProxyForNetworkRules' and 'DNSServers' parameters to 'AzureFirewall'
    • โž• Added 'EnableDnsProxy', 'DnsProxyNotRequiredForNetworkRule' and 'DnsServer' parameters to 'AzureFirewall'
      • Updated cmdlet:
        • New-AzFirewall

    Az.OperationalInsights

    • โšก๏ธ Updated legacy code to apply new generated SDK
    • โœ‚ Deleted cmdlets due to deprecated APIs
      • 'Get-AzOperationalInsightsSavedSearchResult' (alias 'Get-AzOperationalInsightsSavedSearchResults')
      • 'Get-AzOperationalInsightsSearchResult' (alias 'Get-AzOperationalInsightsSearchResults')
      • 'Get-AzOperationalInsightsLinkTarget' (alias 'Get-AzOperationalInsightsLinkTargets')
    • โž• Added parameters for 'Set-AzOperationalInsightsWorkspace' and 'New-AzOperationalInsightsWorkspace'
    • Created cmdlets for Linked Stoarge Account
    • Created cmdlets for Clusters and Linked Service

    Az.RecoveryServices

    • ๐Ÿ‘ Azure Site Recovery added support for protecting proximity placement group virtual machines for Azure to Azure provider.
    • ๐Ÿ‘ Azure Site Recovery added support for zone to zone replication.
    • ๐Ÿ‘ Azure Backup Added Long term retention support for Azure FileShare Recovery Points.
    • Azure Backup Added disk exclusion properties to 'Get-AzRecoveryServicesBackupItem' cmdlet output.
    • โž• Added private endpoint for Vault credential file for site recovery service.

    Az.Resources

    • โž• Added message warning about view delay when creating a new Role Definition
    • ๐Ÿ”„ Changed policy cmdlets to output strongly-typed objects
    • โœ‚ Removed '-TenantLevel' parameter used for on the 'Get-AzResourceLock' cmdlet [#11335]
    • ๐Ÿ›  Fixed 'Remove-AzResourceGroup -Id ResourceId'[#9882]
    • โž• Added new cmdlet for getting ARM template What-If results at resource group scope: 'Get-AzDeploymentResourceGroupWhatIfResult'
    • โž• Added new cmdlet for getting ARM template What-If results at subscription scope: 'Get-AzDeploymentWhatIfResult'
      • Alias: 'Get-AzSubscriptionDeploymentWhatIf'
    • ๐Ÿš€ Overrode '-WhatIf' and '-Confirm' parameters for 'New-AzDeployment' and 'New-AzResourceGroupDeployment' to use ARM template What-If results
    • โž• Added deprecation message for 'ApiVersion' parameter in deployment cmdlets
    • โž• Added capability to show improved error messages for deployment failures
    • โž• Added correlationId logging for deployment failures
    • โž• Added 'error' property to the deployment script output
    • โšก๏ธ Updated nuget Microsoft.Azure.Management.ResourceManager to '3.7.1-preview'
    • โœ‚ Removed specific test cases as Error property in DeploymentValidateResult has changed to readonly from nuget 3.7.1-preview
    • Brought GenericResourceExpanded from SDK ResourceManager 3.7.1-preview
    • โž• Added tag support for all Get cmdlets for deployment, as well as
      • 'New-AzDeployment'
      • 'New-AzManagementGroupDeployment'
      • 'New-AzResourceGroupDeployment'
      • 'New-AzTenantDeployment'

    Az.ServiceFabric

    • ๐Ÿ›  Fixed bug in add certificate using --SecretIdentifier that was getting the wrong certificate thumbprint

    Az.Sql

    • โœจ Enhance performance of:
      • 'Set-AzSqlDatabaseSensitivityClassification'
      • 'Set-AzSqlInstanceDatabaseSensitivityClassification'
      • 'Remove-AzSqlDatabaseSensitivityClassification'
      • 'Remove-AzSqlInstanceDatabaseSensitivityClassification'
      • 'Enable-AzSqlDatabaseSensitivityRecommendation'
      • 'Enable-AzSqlInstanceDatabaseSensitivityRecommendation'
      • 'Disable-AzSqlDatabaseSensitivityRecommendation'
      • 'Disable-AzSqlInstanceDatabaseSensitivityRecommendation'
    • โœ‚ Removed client-side validation of 'RetentionDays' parameter from cmdlet 'Set-AzSqlDatabaseBackupShortTermRetentionPolicy'
    • Auditing to a storage account in Vnet, fixing a bug when creating a Storage Blob Data Contributor role.

    Az.Storage

    • โž• Added '-AsJob' to get/list account cmdlet 'Get-AzStorageAccount'
    • โšก๏ธ Make KeyVersion to optional when update Storage account with KeyvaultEncryption, to support key auto-rotation
      • 'Set-AzStorageAccount'
    • ๐Ÿ›  Fixed remove Azure File Directory fail with pipeline
      • 'Remove-AzStorageDirectory'
    • ๐Ÿ›  Fixed [#9880]: Change NetWorkRule DefaultAction value defination to align with swagger.
      • 'Update-AzStorageAccountNetworkRuleSet'
      • 'Get-AzStorageAccountNetworkRuleSet'
    • ๐Ÿ›  Fixed [#11624]: Skip duplicated rules when add NetworkRules, to avoid server failure
      • 'Add-AzStorageAccountNetworkRule'
    • โฌ†๏ธ Upgraded Microsoft.Azure.Cosmos.Table SDK to 1.0.7
    • โž• Added a warning message to remind user to list again with ContinuationToken when only part items are returned in list DataLake Gen2 Items,
      • 'Get-AzDataLakeGen2ChildItem'
    • ๐Ÿ‘Œ Supported to create or update Storage account with Azure Files Active Directory Domain Service Authentication
      • 'New-AzStorageAccount'
      • 'Set-AzStorageAccount'
    • ๐Ÿ‘Œ Supported to new or list Kerberos keys of Storage account
      • 'New-AzStorageAccountKey'
      • 'Get-AzStorageAccountKey'
    • ๐Ÿ‘Œ Supported failover Storage account
      • 'Invoke-AzStorageAccountFailover'
    • โšก๏ธ Updated help of 'Get-AzStorageBlobCopyState'
    • โšก๏ธ Updated help of 'Get-AzStorageFileCopyState' and 'Start-AzStorageBlobCopy'
    • โ†” Integrated Storage client library v12 to Queue and File cmdlets
    • ๐Ÿ”„ Changed output type from CloudFile to AzureStorageFile, the original output will become a child property of the new output
      • 'Get-AzStorageFile'
      • 'Remove-AzStorageFile'
      • 'Get-AzStorageFileContent'
      • 'Set-AzStorageFileContent'
      • 'Start-AzStorageFileCopy'
    • ๐Ÿ”„ Changed output type from CloudFileDirectory to AzureStorageFileDirectory, the original output will become a child property of the new output
      • 'New-AzStorageDirectory'
      • 'Remove-AzStorageDirectory'
    • ๐Ÿ”„ Changed output type from CloudFileShare to AzureStorageFileShare, the original output will become a child property of the new output
      • 'Get-AzStorageShare'
      • 'New-AzStorageShare'
      • 'Remove-AzStorageShare'
    • ๐Ÿ”„ Changed output type from FileShareProperties to AzureStorageFileShare, the original output will become a sub child property of the new output
      • 'Set-AzStorageShareQuota'

    Az.TrafficManager

    • ๐Ÿ›  Fixed incorrect profile name in 'DisableAzureTrafficManagerEndpoint' verbose output

    Az.Websites

    • ๐Ÿ›  Fixed typo on help of 'Update-AzWebAppAccessRestrictionConfig'.