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

Статья
2025-04-16

В этом документе описаны отличия между версиями 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 (команда для удаления назначения управляемых служб в Azure)
  - Remove-AzManagedServicesDefinition
- Az.ResourceManager
- Az.Sql
  - Set-AzSqlServerActiveDirectoryAdministrator
- Az.Synapse
  - New-AzSynapseSqlPool
  - Update-AzSynapseSqlPool
- Az.Network
  - Approve-AzPrivateEndpointConnection
  - Deny-AzPrivateEndpointConnection
  - Get-AzPrivateEndpointConnection
  - Remove-AzPrivateEndpointConnection (удалить подключение к частной конечной точке)
  - Set-AzPrivateEndpointConnection
  - New-AzNetworkWatcherConnectionMonitorEndpointObject

Аз.Акс

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 указан. Этот функционал был сломан в предыдущей версии командлета. Однако теперь это исправлено.

New-AzFunctionApp

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

Get-AzManagementGroupDeployment

Больше не поддерживает параметр ApiVersion, и для исходного имени параметра не найден псевдоним.

До

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