Edit

Migration Guide for Az 8.0.0

  • Article

Az.Aks

Get-AzAks

Alias Get-AzAks is removed. Please use Get-AzAksCluster instead.

Before

Get-AzAks -ResourceGroupName $resourceGroupName -Name $name

After

Get-AzAksCluster -ResourceGroupName $resourceGroupName -Name $name

New-AzAks

Alias New-AzAks is removed. Please use New-AzAksCluster instead.

Before

New-AzAks -ResourceGroupName $resourceGroupName -Name $name -Location $location

After

New-AzAksCluster -ResourceGroupName $resourceGroupName -Name $name -Location $location

Set-AzAks

Alias Set-AzAks is removed. Please use Set-AzAksCluster instead.

Before

Set-AzAks -ResourceGroupName $resourceGroupName -Name $name

After

Set-AzAksCluster -ResourceGroupName $resourceGroupName -Name $name

Remove-AzAks

Alias Remove-AzAks is removed. Please use Remove-AzAksCluster instead.

Before

Remove-AzAks -ResourceGroupName $resourceGroupName -Name $name

After

Remove-AzAksCluster -ResourceGroupName $resourceGroupName -Name $name

Az.Cdn

New-AzCdnProfile

Changed the type of parameter Sku to SkuName Changed the type of parameter ProfileName to Name

Before

$profileSku = "Standard_Microsoft";
$cdnProfileName = "profileNameXXXX";
$resourceGroupName = "myresourcegroup"
New-AzCdnProfile -Sku $profileSku -ProfileName $cdnProfileName -ResourceGroupName $resourceGroupName -Location Global

After

$profileSku = "Standard_Microsoft";
$cdnProfileName = "profileNameXXXX";
$resourceGroupName = "myresourcegroup"
New-AzCdnProfile -SkuName $profileSku -Name $cdnProfileName -ResourceGroupName $resourceGroupName -Location Global

New-AzCdnEndpoint

Changed parameter EndpointName to Name Changed parameter GeoFilters to GeoFilter Changed parameter DefaultOriginGroup to DefaultOriginGroupId Merge parameters OriginHostName,OriginId,OriginName,Priority,PrivateLinkApprovalMessage,PrivateLinkLocation,PrivateLinkResourceId,Weight,HttpPort,HttpsPortinto parameter Origin Merge parameters OriginGroupName,OriginGroupProbeIntervalInSeconds,OriginGroupProbePath,OriginGroupProbeProtocol,OriginGroupProbeRequestTypeinto parameter OriginGroup Split parameter DeliveryPolicy in to parameters DeliveryPolicyDescription,DeliveryPolicyRule Add parameters SubscriptionId,UrlSigningKey,WebApplicationFirewallPolicyLinkId Delete parameter CdnProfile

Before

New-AzCdnEndpoint -ResourceGroupName myresourcegroup -ProfileName mycdnprofile -Location westus -EndpointName myendpoint `
                  -OriginName mystorage -OriginHostName mystorage.blob.core.windows.net `
                  -OriginHostHeader mystorage.blob.core.windows.net -IsHttpAllowed $false

After

$origin = @{
  Name = "origin1"
  HostName = "host1.hello.com"
};
$location = "westus"

$endpoint = New-AzCdnEndpoint -Name $endpointName -ResourceGroupName $ResourceGroupName -ProfileName $cdnProfileName -Location $location -Origin $origin

New-AzCdnDeliveryPolicy

Delete command New-AzCdnDeliveryPolicy. Use New-AzCdnDeliveryRuleObject create rule object and used it in New-AzCdnEndpoint directly

New-AzCdnDeliveryRule

Changed command name to New-AzCdnDeliveryRuleObject

Before

New-AzCdnDeliveryRule -Name "rule1" -Order 1 -Condition $cond1 -Action $action1

After

$cond1 = New-AzCdnDeliveryRuleIsDeviceConditionObject -Name "IsDevice" -ParameterMatchValue "Desktop"
$action1 = New-AzCdnUrlRewriteActionObject -Name "UrlRewrite" -ParameterDestination "/def" -ParameterSourcePattern "/abc" -ParameterPreserveUnmatchedPath $true
$rule1 = New-AzCdnDeliveryRuleObject -Name "Rule1" -Action $action1,$action2 -Condition $cond1 -Order 1

New-AzCdnCustomDomain

Changed the type of parameter CustomDomainName to Name Add parameter SubscriptionId Delete parameter CdnEndpoint

Before

New-AzCdnCustomDomain -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName -CustomDomainName $customDomainName -HostName $customDomainHostName

After

New-AzCdnCustomDomain -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName -Name $customDomainName -HostName $customDomainHostName -SubscriptionId $subId

Set-AzCdnProfile

Replaced by command Update-AzCdnProfile

Before

$profileObject = Get-AzCdnProfile -ResourceGroupName myresourcegroup -ProfileName mycdnprofile
$profileObject.Tags = @{"key"="value"}
Set-AzCdnProfile -CdnProfile $profileObject

After

$profileSku = "Standard_Microsoft";
$cdnProfileName = "profileNameXXXX";
$resourceGroupName = "myresourcegroup"
New-AzCdnProfile -SkuName $profileSku -Name $cdnProfileName -ResourceGroupName $resourceGroupName -Location Global

$tags = @{
  Tag1 = 11
  Tag2  = 22
}
Update-AzCdnProfile -Name $cdnProfileName -ResourceGroupName $resourceGroupName -Tag $tags

Set-AzCdnEndpoint

Replaced by command Update-AzCdnEndpoint DeliveryPolicyDescription and DeliveryPolicyRule should be provided together when you want to update one of them.

Before

$endpointObject = Get-AzCdnEndpoint -ResourceGroupName myresourcegroup -ProfileName mycdnprofile -EndpointName myendpoint
$endpointObject.IsHttpAllowed = $false
Set-AzCdnEndpoint -CdnEndpoint $endpointObject

After

$tags = @{
  Tag1 = 11
  Tag2  = 22
}

//Update tags
Update-AzCdnEndpoint -Name $endpointName -ProfileName $cdnProfileName -ResourceGroupName $resourceGroupName -Tag $tags

//Update DeliveryPolicyDescription or DeliveryPolicyRule
Update-AzCdnEndpoint -Name $endpointName -ProfileName $cdnProfileName -ResourceGroupName $resourceGroupName `
   -DeliveryPolicyDescription $descprption -DeliveryPolicyRule $rule

Set-AzCdnOriginGroup

Replaced by command Update-AzCdnOriginGroup

Before

Set-AzCdnOriginGroup -ResourceGroupName $resourceGroupName -ProfileName $profileName -EndpointName $endpointName -OriginGroupName $originGroupName -OriginId $originIds -ProbeIntervalInSeconds $probeInterval

After

Update-AzCdnOriginGroup -EndpointName $endpointName -Name $originGroup.Name -ProfileName $cdnProfileName -ResourceGroupName $ResourceGroupName `
                -HealthProbeSetting $healthProbeParametersObject2 -Origin @(@{ Id = $originId })

Set-AzCdnOrigin

Replaced by command Update-AzCdnOrigin

Before

Set-AzCdnOrigin -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName `
    -OriginName $originName -HostName "mystorage2.blob.core.windows.net"

After

Update-AzCdnOrigin -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName `
    -Name $originName  -HostName "mystorage2.blob.core.windows.net" -HttpPort 456 -HttpsPort 789

Unpublish-AzCdnEndpointContent

Replaced by command Clear-AzCdnEndpointContent

Before

Unpublish-AzCdnEndpointContent -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName `
   -PurgeContent $PurgeContent

After

Clear-AzCdnEndpointContent -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName `
   -ContentPath $PurgeContent

Publish-AzCdnEndpointContent

Replaced by command Import-AzCdnEndpointContent

Before

Publish-AzCdnEndpointContent -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName `
   -LoadContent $LoadContent

After

Import-AzCdnEndpointContent -ResourceGroupName $resourceGroupName -ProfileName $cdnProfileName -EndpointName $endpointName `
   -ContentPath $LoadContent

Az.EventHub

New-AzEventHubNamespace

Parameter Identity is removed.

Before

New-AzEventHubNamespace -ResourceGroupName myresourcegroup -Name MyNamespaceName -Location northeurope -SkuName Premium -IdentityType SystemAssigned -Identity

After

New-AzEventHubNamespace -ResourceGroupName myresourcegroup -Name MyNamespaceName -Location northeurope -SkuName Premium -IdentityType SystemAssigned

Set-AzEventHubNamespace

Parameter Identity is removed.

Before

Set-AzEventHubNamespace -ResourceGroupName myresourcegroup -Name MyNamespaceName -EncryptionConfig $ec1,$ec2 -Identity

After

Set-AzEventHubNamespace -ResourceGroupName myresourcegroup -Name MyNamespaceName -EncryptionConfig $ec1,$ec2

Az.HealthcareApis

Set-AzHealthcareApisService

Combine New-AzHealthcareApisService and Set-AzHealthcareApisService into New-AzHealthcareApisService

Before

Set-AzHealthcareApisService -Name MyService -ResourceGroupName MyResourceGroup -CosmosOfferThroughput 500

After

New-AzHealthcareApisService -Name MyService -ResourceGroupName MyResourceGroup -Location MyLocation -Kind fhir-R4 -CosmosOfferThroughput 500

Get-AzHealthcareApisService

-ResourceId is removed

Before

Get-AzHealthcareApisService -ResourceId $ResourceId

After

Get-AzHealthcareApisService -ResourceGroupName $ResourceGroup -Name $Name

Remove-AzHealthcareApisService

-ResourceId is removed

Before

Remove-AzHealthcareApisService -ResourceId $ResourceId

After

Remove-AzHealthcareApisService -ResourceGroupName $ResourceGroup -Name $Name

New-AzHealthcareApisService

-ManagedIdentity is renamed to -IdentityType -FhirVersion is removed and the desired content can be selected with the parameter -Kind -DisableCorsCredential and -AllowCorsCredential: now uniformly named as -AllowCorsCredential, example: -AllowCorsCredential:$false or -AllowCorsCredential:$true -DisableSmartProxy and -EnableSmartProxy: now uniformly named as -EnableSmartProxy, example: -EnableSmartProxy:$false or -EnableSmartProxy:$true

Before

New-AzHealthcareApisService -Name MyService -ResourceGroupName MyResourceGroup -Location MyLocation -FhirVersion fhir-R4 -CosmosOfferThroughput 500 -ManagedIdentity $IdentityType -DisableCorsCredential -DisableSmartProxy

After

New-AzHealthcareApisService -Name MyService -ResourceGroupName MyResourceGroup -Location MyLocation -Kind fhir-R4 -CosmosOfferThroughput 500 -IdentityType $IdentityType -AllowCorsCredential:$false -EnableSmartProxy:$false