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

Az 5.0.0 迁移指南

2025-06-05

本文档介绍 Az 4.0.0 和 5.0.0 版本之间的更改。

Az 5.0.0 迁移指南
- Az.Aks
  - New-AzAksCluster
  - Set-AzAksCluster
- Az.ContainerRegistry
  - New-AzContainerRegistry
- Az.Functions
  - Get-AzFunctionApp
  - New-AzFunctionApp
- Az.KeyVault
- Az.ManagedServices
  - Get-AzManagedServicesDefinition
  - New-AzManagedServicesAssignment
  - Remove-AzManagedServicesAssignment（删除 Az 托管服务分配）
  - Remove-AzManagedServicesDefinition
- Az.ResourceManager
  - Get-AzManagementGroupDeployment
  - 获取Az管理组部署操作
  - Get-AzDeployment
  - Get-AzDeploymentOperation
  - Get-AzDeploymentWhatIfResult
  - Get-AzTenantDeployment
  - Get-AzTenantDeploymentOperation
  - New-AzManagementGroupDeployment
  - New-AzDeployment
  - New-AzTenantDeployment
  - Remove-AzManagementGroupDeployment（删除 Az 管理组部署）
  - Remove-AzDeployment
  - Remove-AzTenantDeployment
  - Save-AzManagementGroupDeploymentTemplate（保存 Az 管理组部署模板）
  - Save-AzDeploymentTemplate
  - Save-AzTenantDeploymentTemplate
  - Stop-AzManagementGroupDeployment
  - Stop-AzDeployment
  - Stop-AzTenantDeployment
  - Test-AzManagementGroupDeployment
  - Test-AzDeployment
  - Test-AzTenantDeployment
  - Get-AzResourceGroupDeployment
  - 获取-Az资源组部署操作
  - Get-AzResourceGroupDeploymentWhatIfResult
  - New-AzResourceGroupDeployment
  - Remove-AzResourceGroupDeployment
  - Save-AzResourceGroupDeploymentTemplate
  - Stop-AzResourceGroupDeployment（停止 Azure 资源组部署）
  - Test-AzResourceGroupDeployment（测试-Az资源组部署）
  - Get-AzManagementGroupDeploymentWhatIfResult
  - Get-AzTenantDeploymentWhatIfResult（获取Az租户部署假设结果）
- Az.Sql
  - Set-AzSqlServerActiveDirectoryAdministrator
- Az.Synapse
  - New-AzSynapseSqlPool
  - Update-AzSynapseSqlPool
- Az.Network

Az.Aks

New-AzAksCluster

不再支持该参数 NodeOsType ，并且找不到原始参数名称的别名，它始终为 Linux。
不再支持参数 ClientIdAndSecret 的别名 ServicePrincipalIdAndSecret。
NodeVmSetType默认值从AvailabilitySet更改为 VirtualMachineScaleSets。
NetworkPlugin默认值从none更改为 azure。

之前

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

之后

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

Set-AzAksCluster

不再支持参数 ClientIdAndSecret 的别名 ServicePrincipalIdAndSecret。

之前

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

之后

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

Az.容器注册表

New-AzContainerRegistry

不再支持参数 StorageAccountName，找不到原始参数名称的别名。

之前

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

之后

Classic 已弃用并 StorageAccountName 已删除，因为它仅适用于经典容器注册表。

Az.Functions

Get-AzFunctionApp

已从 IncludeSlot 的一个参数集以外的所有参数集删除 Get-AzFunctionApp 开关参数。指定 -IncludeSlot 后，该 cmdlet 现在支持检索结果中的部署槽。在以前的 cmdlet 版本中，此功能已中断。但是，现在已修复此问题。

New-AzFunctionApp

修复了-DisableApplicationInsights中的New-AzFunctionApp，以便在指定此选项时不创建 Application Insights 项目。
删除了对创建 PowerShell 6.2 函数应用的支持，因为 PowerShell 6.2 已达到寿命终止。客户的当前指南是改为创建 PowerShell 7.0 函数应用。
未指定 RuntimeVersion 参数时，将 Windows 上用于 PowerShell 函数应用的 Functions 版本 3 的默认运行时版本从 6.2 更改为 7.0。
如果未指定 RuntimeVersion 参数，Windows 和 Linux 上用于 Node 函数应用的 Functions 版本 3 的默认运行时版本将从 10 更改为 12。但是，用户仍可以通过指定 -Runtime Node 和 -RuntimeVersion 10创建 Node 10 函数应用。未指定 RuntimeVersion 参数时，将 Functions 版本 3（用于 Linux 的 Python 函数应用）的默认运行时版本从 3.7 更改为 3.8。但是，用户仍可以通过指定 -Runtime Python 和 -RuntimeVersion 3.7创建 Python 3.7 函数应用。

之前

# 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

之后

# 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

不再支持参数 DisableSoftDelete，找不到原始参数名称的别名。

之前

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

之后

Az.KeyVault 3.0.0 中弃用了更新软删除设置的功能。阅读更多

Update-AzKeyVault

不再支持参数 EnableSoftDelete， SoftDeleteRetentionInDays并且找不到原始参数名称的别名。

之前

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

之后

Az.KeyVault 3.0.0 中弃用了更新软删除设置的功能。阅读更多

Get-AzKeyVaultSecret

类型为SecretValueText的属性Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret已被删除。可以在调用时应用 -AsPlainText 以获取纯文本形式的机密，或者在脚本中使用类型为 $secret.SecretValue 的 SecureString。

之前

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

之后

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

Az.ManagedServices

Get-AzManagedServicesDefinition

不再支持参数 ResourceId，找不到原始参数名称的别名。

之前

Get-AzManagedServicesDefinition -ResourceId xxx

之后

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

不再支持参数 RegistrationDefinitionName， RegistrationDefinitionResourceId并且找不到原始参数名称的别名。

之前

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

之后

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

不再支持参数 Id， ResourceId并且找不到原始参数名称的别名。

之前

Remove-AzManagedServicesAssignment -ResourceId xxx

之后

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

不再支持参数 Id， ResourceId并且找不到原始参数名称的别名。

之前

Remove-AzManagedServicesDefinition -ResourceId xxx

之后

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.资源管理器

Get-AzManagementGroupDeployment

不再支持参数 ApiVersion，找不到原始参数名称的别名。

之前

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