你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Migration Guide for Az 5.0.0

项目
11/19/2024

This document describes the changes between the 4.0.0 and 5.0.0 versions of Az.

Migration Guide for Az 5.0.0

Az.Aks

New-AzAksCluster

No longer supports the parameter NodeOsType and no alias was found for the original parameter name, it will always be Linux.
No longer supports the alias ClientIdAndSecret for parameter ServicePrincipalIdAndSecret.
The default value of NodeVmSetType is changed from AvailabilitySet to VirtualMachineScaleSets.
The default value of NetworkPlugin is changed from none to azure.

Before

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeOsType Linux -ClientIdAndSecret xxx

After

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NodeVmSetType AvailabilitySet  -ServicePrincipalIdAndSecret xxx

Set-AzAksCluster

No longer supports the alias ClientIdAndSecret for parameter ServicePrincipalIdAndSecret.

Before

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ClientIdAndSecret xxx

After

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ServicePrincipalIdAndSecret xxx

Az.ContainerRegistry

New-AzContainerRegistry

No longer supports the parameter StorageAccountName and no alias was found for the original parameter name.

Before

New-AzContainerRegistry -Name $name -ResourceGroupName $rg -Location $location -SKU Classic -StorageAccountName $storage

After

Classic was deprecated and StorageAccountName was removed since it only works with Classic Container Registry.

Az.Functions

Get-AzFunctionApp

Removed IncludeSlot switch parameter from all but one parameter set of Get-AzFunctionApp. The cmdlet now supports retrieving deployment slots in the results when -IncludeSlot is specified. This functionality was broken in the previous cmdlet version. However, this is now fixed.

New-AzFunctionApp

Fixed -DisableApplicationInsights in New-AzFunctionApp so that no application insights project is created when this option is specified.
Removed support to create PowerShell 6.2 function apps since PowerShell 6.2 is EOL. The current guidance for customers is to create PowerShell 7.0 function apps instead.
Changed the default runtime version in Functions version 3 on Windows for PowerShell function apps from 6.2 to 7.0 when the RuntimeVersion parameter is not specified.
Changed the default runtime version in Functions version 3 on Windows and Linux for Node function apps from 10 to 12 when the RuntimeVersion parameter is not specified. However, users can still create Node 10 function apps by specifying -Runtime Node and -RuntimeVersion 10. Changed the default runtime version in Functions version 3 on Linux for Python function apps from 3.7 to 3.8 when the RuntimeVersion parameter is not specified. However, users can still create Python 3.7 function apps by specifying -Runtime Python and -RuntimeVersion 3.7.

Before

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python

After

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node `
                  -RuntimeVersion 10

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python `
                  -RuntimeVersion 3.7

Az.KeyVault

New-AzKeyVault

No longer supports the parameter DisableSoftDelete and no alias was found for the original parameter name.

Before

# Opt out soft delete while creating a key vault
New-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -Location 'East US' -DisableSoftDelete

After

The ability to update soft-delete setting is deprecated in Az.KeyVault 3.0.0. Read more

Update-AzKeyVault

No longer supports the parameter EnableSoftDelete, SoftDeleteRetentionInDays, and no alias was found for the original parameter name.

Before

Update-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -EnableSoftDelete -SoftDeleteRetentionInDays 15

After

The ability to update soft-delete setting is deprecated in Az.KeyVault 3.0.0. Read more

Get-AzKeyVaultSecret

The property SecretValueText of type Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret has been removed. Either apply a -AsPlainText to the call to get the plain text secret, or use $secret.SecretValue of type SecureString in your script.

Before

$secret = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret
$secretInPlainText = $secret.SecretValueText

After

$secretInPlainText = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret -AsPlainText

Az.ManagedServices

Get-AzManagedServicesDefinition

No longer supports the parameter ResourceId and no alias was found for the original parameter name.

Before

Get-AzManagedServicesDefinition -ResourceId xxx

After

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

No longer supports the parameter RegistrationDefinitionName, RegistrationDefinitionResourceId, and no alias was found for the original parameter name.

Before

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

After

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

No longer supports the parameter Id, ResourceId, and no alias was found for the original parameter name.

Before

Remove-AzManagedServicesAssignment -ResourceId xxx

After

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

No longer supports the parameter Id, ResourceId, and no alias was found for the original parameter name.

Before

Remove-AzManagedServicesDefinition -ResourceId xxx

After

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

No longer supports the parameter ApiVersion and no alias was found for the original parameter name.

Before

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx -ApiVersion xxx