Руководство по миграции Az 5.0.0

Статья
01/15/2025

В этом документе описываются изменения между версиями 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, кроме одного. Теперь командлет поддерживает получение слотов развертывания в результатах при указании -IncludeSlot. Эта функция была нарушена в предыдущей версии командлета. Однако теперь это исправлено.

New-AzFunctionApp

Исправлено -DisableApplicationInsights в New-AzFunctionApp так, чтобы при указании этого параметра проект Application Insights не создавался.
Удалена поддержка создания приложений-функций PowerShell 6.2 из-за окончания срока службы PowerShell 6.2. В настоящее время клиентам рекомендуется вместо этого создавать функции-приложения PowerShell 7.0.
Изменена версия среды выполнения по умолчанию в функциональных приложениях на Windows версии 3 для PowerShell из 6.2 на 7.0, если параметр RuntimeVersion не указан.
Изменено значение версии среды выполнения по умолчанию на Functions версии 3 в Windows и Linux для Node-приложений с 10 на 12, если параметр RuntimeVersion не указан. Однако пользователи по-прежнему могут создавать приложения-функции Node 10, указывая -Runtime Node и -RuntimeVersion 10. Изменена версия среды выполнения по умолчанию в Azure Functions версии 3 на Linux для приложений-функций Python с 3.7 на 3.8, если параметр RuntimeVersion не указан. Однако пользователи по-прежнему могут создавать приложения-функции Python 3.7, указывая -Runtime Python и -RuntimeVersion 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