Az 3.0.0
Gallery Module for ARM .NET Standard cmdlets: link
Migration Guide for Az 3.0: link
To install Az
from the PowerShell Gallery, run the following command:
Install-Module -Name Az -Repository PSGallery -Force
To update from an older version of Az
, run the following command:
Update-Module -Name Az
Changes since last release
General
- Az.PrivateDns 1.0.0 released
Az.Accounts
- Add a deprecation message for 'Resolve-Error' alias.
Az.Advisor
- Added new category 'Operational Excellence' to Get-AzAdvisorRecommendation cmdlet.
Az.Batch
- Renamed
CoreQuota
onBatchAccountContext
toDedicatedCoreQuota
. There is also a newLowPriorityCoreQuota
.- This impacts Get-AzBatchAccount.
- New-AzBatchTask
-ResourceFile
parameter now takes a collection ofPSResourceFile
objects, which can be constructed using the new New-AzBatchResourceFile cmdlet. - New New-AzBatchResourceFile cmdlet to help create
PSResourceFile
objects. These can be supplied to New-AzBatchTask on the-ResourceFile
parameter.- This supports two new kinds of resource file in addition to the existing
HttpUrl
way:AutoStorageContainerName
based resource files download an entire auto-storage container to the Batch node.StorageContainerUrl
based resource files download the container specified in the URL to the Batch node.
- This supports two new kinds of resource file in addition to the existing
- Removed
ApplicationPackages
property ofPSApplication
returned by Get-AzBatchApplication.- The specific packages inside of an application now can be retrieved using Get-AzBatchApplicationPackage. For example:
Get-AzBatchApplication -AccountName myaccount -ResourceGroupName myresourcegroup -ApplicationId myapplication
.
- The specific packages inside of an application now can be retrieved using Get-AzBatchApplicationPackage. For example:
- Renamed
ApplicationId
toApplicationName
on Get-AzBatchApplicationPackage, New-AzBatchApplicationPackage, Remove-AzBatchApplicationPackage, Get-AzBatchApplication, New-AzBatchApplication, Remove-AzBatchApplication, and Set-AzBatchApplication.ApplicationId
now is an alias ofApplicationName
.
- Added new
PSWindowsUserConfiguration
property toPSUserAccount
. - Renamed
Version
toName
onPSApplicationPackage
. - Renamed
BlobSource
toHttpUrl
onPSResourceFile
. - Removed
OSDisk
property fromPSVirtualMachineConfiguration
. - Removed Set-AzBatchPoolOSVersion. This operation is no longer supported.
- Removed
TargetOSVersion
fromPSCloudServiceConfiguration
. - Renamed
CurrentOSVersion
toOSVersion
onPSCloudServiceConfiguration
. - Removed
DataEgressGiB
andDataIngressGiB
fromPSPoolUsageMetrics
. - Removed Get-AzBatchNodeAgentSku and replaced it with Get-AzBatchSupportedImage.
- Get-AzBatchSupportedImage returns the same data as Get-AzBatchNodeAgentSku but in a more friendly format.
- New non-verified images are also now returned. Additional information about
Capabilities
andBatchSupportEndOfLife
for each image is also included.
- Added ability to mount remote file-systems on each node of a pool via the new
MountConfiguration
parameter of New-AzBatchPool. - Now support network security rules blocking network access to a pool based on the source port of the traffic. This is done via the
SourcePortRanges
property onPSNetworkSecurityGroupRule
. - When running a container, Batch now supports executing the task in the container working directory or in the Batch task working directory. This is controlled by the
WorkingDirectory
property onPSTaskContainerSettings
. - Added ability to specify a collection of public IPs on
PSNetworkConfiguration
via the newPublicIPs
property. This guarantees nodes in the Pool will have an IP from the list user provided IPs. - When not specified, the default value of
WaitForSuccess
onPSSTartTask
is now$True
(was$False
). - When not specified, the default value of
Scope
onPSAutoUserSpecification
is nowPool
(wasTask
on Windows andPool
on Linux).
Az.Cdn
- Introduced UrlRewriteAction and CacheKeyQueryStringAction to RulesEngine.
- Fixed several bugs like missing 'Selector' Input in New-AzDeliveryRuleCondition cmdlet.
Az.Compute
- Disk Encryption Set feature
- New cmdlets:
New-AzDiskEncryptionSetConfig
New-AzDiskEncryptionSet
Get-AzDiskEncryptionSet
Remove-AzDiskEncryptionSet - DiskEncryptionSetId parameter is added to the following cmdlets:
Set-AzImageOSDisk
Set-AzVMOSDisk
Set-AzVmssStorageProfile
Add-AzImageDataDisk
New-AzVMDataDisk
Set-AzVMDataDisk
Add-AzVMDataDisk
Add-AzVmssDataDisk
Add-AzVmssVMDataDisk - DiskEncryptionSetId and EncryptionType parameters are added to the following cmdlets:
New-AzDiskConfig
New-AzSnapshotConfig
- New cmdlets:
- Add PublicIPAddressVersion parameter to New-AzVmssIPConfig
- Move FileUris of custom script extension from public setting to protected setting
- Add ScaleInPolicy to New-AzVmss, New-AzVmssConfig and Update-AzVmss cmdlets
- Breaking changes
- UploadSizeInBytes parameter is used instead of DiskSizeGB for New-AzDiskConfig when CreateOption is Upload
- PublishingProfile.Source.ManagedImage.Id is replaced with StorageProfile.Source.Id in GalleryImageVersion object
Az.DataFactory
- Update ADF .Net SDK version to 4.3.0
Az.DataLakeStore
- Update ADLS SDK version (https://github.com/Azure/azure-data-lake-store-net/blob/preview-alpha/CHANGELOG.md#version-123-alpha), brings following fixes
- Avoid throwing exception while unable to deserialize the creationtime of the trash or directory entry.
- Expose setting per request timeout in adlsclient
- Fix passing the original syncflag for badoffset recovery
- Fix EnumerateDirectory to retrieve continuation token once response is checked
- Fix Concat Bug
Az.FrontDoor
- Fixed miscellaneous typos across module
Az.HDInsight
- Fixed the bug that customer will get 'Not a valid Base-64 string' error when using Get-AzHDInsightCluster to get the cluster with ADLSGen1 storage.
- Add a parameter named 'ApplicationId' to three cmdlets Add-AzHDInsightClusterIdentity, New-AzHDInsightClusterConfig and New-AzHDInsightCluster so that customer can provide the service principal application id for accessing Azure Data Lake.
- Changed Microsoft.Azure.Management.HDInsight from 2.1.0 to 5.1.0
- Removed five cmdlets:
- Get-AzHDInsightOMS
- Enable-AzHDInsightOMS
- Disable-AzHDInsightOMS
- Grant-AzHDInsightRdpServicesAccess
- Revoke-AzHDInsightRdpServicesAccess
- Added three cmdlets:
- Get-AzHDInsightMonitoring to replace Get-AzHDInsightOMS.
- Enable-AzHDInsightMonitoring to replace Enable-AzHDInsightOMS.
- Disable-AzHDInsightMonitoring to replace Disable-AzHDInsightOMS.
- Fixed cmdlet Get-AzHDInsightProperties to support get capabilities information from a specific location.
- Removed parameter sets('Spark1', 'Spark2') from Add-AzHDInsightConfigValue.
- Add examples to the help documents of cmdlet Add-AzHDInsightSecurityProfile.
- Changed output type of the following cmdlets:
-
- Changed the output type of Get-AzHDInsightProperties from CapabilitiesResponse to AzureHDInsightCapabilities.
-
- Changed the output type of Remove-AzHDInsightCluster from ClusterGetResponse to bool.
-
- Changed the output type of Set-AzHDInsightGatewaySettings HttpConnectivitySettings to GatewaySettings.
- Added some scenario test cases.
- Remove some alias: 'Add-AzHDInsightConfigValues', 'Get-AzHDInsightProperties'.
Az.IotHub
- Breaking changes:
- The cmdlet 'Add-AzIotHubEventHubConsumerGroup' no longer supports the parameter 'EventHubEndpointName' and no alias was found for the original parameter name.
- The parameter set '__AllParameterSets' for cmdlet 'Add-AzIotHubEventHubConsumerGroup' has been removed.
- The cmdlet 'Get-AzIotHubEventHubConsumerGroup' no longer supports the parameter 'EventHubEndpointName' and no alias was found for the original parameter name.
- The parameter set '__AllParameterSets' for cmdlet 'Get-AzIotHubEventHubConsumerGroup' has been removed.
- The property 'OperationsMonitoringProperties' of type 'Microsoft.Azure.Commands.Management.IotHub.Models.PSIotHubProperties' has been removed.
- The property 'OperationsMonitoringProperties' of type 'Microsoft.Azure.Commands.Management.IotHub.Models.PSIotHubInputProperties' has been removed.
- The cmdlet 'New-AzIotHubExportDevice' no longer supports the alias 'New-AzIotHubExportDevices'.
- The cmdlet 'New-AzIotHubImportDevice' no longer supports the alias 'New-AzIotHubImportDevices'.
- The cmdlet 'Remove-AzIotHubEventHubConsumerGroup' no longer supports the parameter 'EventHubEndpointName' and no alias was found for the original parameter name.
- The parameter set '__AllParameterSets' for cmdlet 'Remove-AzIotHubEventHubConsumerGroup' has been removed.
- The cmdlet 'Set-AzIotHub' no longer supports the parameter 'OperationsMonitoringProperties' and no alias was found for the original parameter name.
- The parameter set 'UpdateOperationsMonitoringProperties' for cmdlet 'Set-AzIotHub' has been removed.
Az.RecoveryServices
- Azure Site Recovery support to configure networking resources like NSG, public IP and internal load balancers for Azure to Azure.
- Azure Site Recovery Support to write to managed disk for vMWare to Azure.
- Azure Site Recovery Support to NIC reduction for vMWare to Azure.
- Azure Site Recovery Support to accelerated networking for Azure to Azure.
- Azure Site Recovery Support to agent auto update for Azure to Azure.
- Azure Site Recovery Support to Standard SSD for Azure to Azure.
- Azure Site Recovery Support to Azure Disk Encryption two pass for Azure to Azure.
- Azure Site Recovery Support to protect newly added disk for Azure to Azure.
- Added SoftDelete feature for VM and added tests for softdelete
Az.Resources
- Update dependency assembly Microsoft.Extensions.Caching.Memory from 1.1.1 to 2.2
Az.Network
- Change all cmdlets for PrivateEndpointConnection to support generic service provider.
- Updated cmdlet:
- Approve-AzPrivateEndpointConnection
- Deny-AzPrivateEndpointConnection
- Get-AzPrivateEndpointConnection
- Remove-AzPrivateEndpointConnection
- Set-AzPrivateEndpointConnection
- Updated cmdlet:
- Add new cmdlet for PrivateLinkResource and it also support generic service provider.
- New cmdlet:
- Get-AzPrivateLinkResource
- New cmdlet:
- Add new fields and parameter for the feature Proxy Protocol V2.
- Add property EnableProxyProtocol in PrivateLinkService
- Add property LinkIdentifier in PrivateEndpointConnection
- Updated New-AzPrivateLinkService to add a new optional parameter EnableProxyProtocol.
- Fix incorrect parameter description in 'New-AzApplicationGatewaySku' reference documentation
- New cmdlets to support the azure firewall policy
- Add support for child resource RouteTables of VirtualHub
- New cmdlets added:
- Add-AzVirtualHubRoute
- Add-AzVirtualHubRouteTable
- Get-AzVirtualHubRouteTable
- Remove-AzVirtualHubRouteTable
- Set-AzVirtualHub
- New cmdlets added:
- Add support for new properties Sku of VirtualHub and VirtualWANType of VirtualWan
- Cmdlets updated with optional parameters:
- New-AzVirtualHub : added parameter Sku
- Update-AzVirtualHub : added parameter Sku
- New-AzVirtualWan : added parameter VirtualWANType
- Update-AzVirtualWan : added parameter VirtualWANType
- Cmdlets updated with optional parameters:
- Add support for EnableInternetSecurity property for HubVnetConnection, VpnConnection and ExpressRouteConnection
- New cmdlets added:
- Update-AzureRmVirtualHubVnetConnection
- Cmdlets updated with optional parameters:
- New-AzureRmVirtualHubVnetConnection : added parameter EnableInternetSecurity
- New-AzureRmVpnConnection : added parameter EnableInternetSecurity
- Update-AzureRmVpnConnection : added parameter EnableInternetSecurity
- New-AzureRmExpressRouteConnection : added parameter EnableInternetSecurity
- Set-AzureRmExpressRouteConnection : added parameter EnableInternetSecurity
- New cmdlets added:
- Add support for Configuring TopLevel WebApplicationFirewall Policy
- New cmdlets added:
- New-AzApplicationGatewayFirewallPolicySetting
- New-AzApplicationGatewayFirewallPolicyExclusion
- New-AzApplicationGatewayFirewallPolicyManagedRuleGroupOverride
- New-AzApplicationGatewayFirewallPolicyManagedRuleOverride
- New-AzApplicationGatewayFirewallPolicyManagedRule
- New-AzApplicationGatewayFirewallPolicyManagedRuleSet
- Cmdlets updated with optional parameters:
- New-AzApplicationGatewayFirewallPolicy : added parameter PolicySetting, ManagedRule
- New cmdlets added:
- Added support for Geo-Match operator on CustomRule
- Added GeoMatch to the operator on the FirewallCondition
- Added support for perListener and perSite Firewall policy
- Cmdlets updated with optional parameters:
- New-AzApplicationGatewayHttpListener : added parameter FirewallPolicy, FirewallPolicyId
- New-AzApplicationGatewayPathRuleConfig : added parameter FirewallPolicy, FirewallPolicyId
- Cmdlets updated with optional parameters:
- Fix required subnet with name AzureBastionSubnet in 'PSBastion' can be case insensitive
- Support for Destination FQDNs in Network Rules and Translated FQDN in NAT Rules for Azure Firewall
- Add support for top level resource RouteTables of IpGroup
- New cmdlets added:
- New-AzIpGroup
- Remove-AzIpGroup
- Get-AzIpGroup
- Set-AzIpGroup
- New cmdlets added:
Az.ServiceFabric
- Remove Add-AzServiceFabricApplicationCertificate cmdlet as this scenario is covered by Add-AzVmssSecret.
Az.Sql
- Added support for restore of dropped databases on Managed Instances.
- Deprecated from code old auditing cmdlets.
- Removed deprecated aliases:
- Get-AzSqlDatabaseIndexRecommendations (use Get-AzSqlDatabaseIndexRecommendation instead)
- Get-AzSqlDatabaseRestorePoints (use Get-AzSqlDatabaseRestorePoint instead)
- Remove Get-AzSqlDatabaseSecureConnectionPolicy cmdlet
- Remove aliases for deprecated Vulnerability Assessment Settings cmdlets
- Deprecate Advanced Threat Detection Settings cmdlets
- Adding cmdlets to Disable and enable sensitivity recommendations on columns in a database.
Az.Storage
- Support enable Large File share when create or update Storage account
- New-AzStorageAccount
- Set-AzStorageAccount
- When close/get File handle, skip check the input path is File directory or File, to avoid failure with object in DeletePending status
- Get-AzStorageFileHandle
- Close-AzStorageFileHandle