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

Az 5.0.0 迁移指南

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

Az 5.0.0 迁移指南

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.ContainerRegistry

New-AzContainerRegistry

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

之前

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

之后

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

Az.Functions

Get-AzFunctionApp

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

New-AzFunctionApp

修复了-DisableApplicationInsights以下问题New-AzFunctionApp：指定此选项时不会创建 Application Insights 项目。
删除了创建 PowerShell 6.2 函数应用的支持，因为 PowerShell 6.2 是 EOL。客户的当前指南是改为创建 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 ，将 Linux 上适用于 Python 函数应用的 Functions 版本 3 中的默认运行时版本从 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.ResourceManager

Get-AzManagementGroupDeployment

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

之前

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