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

В этом документе описываются изменения между версиями Az 4.0.0 и 5.0.0.

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

Az.Aks

New-AzAksCluster

Больше не поддерживает параметр NodeOsType и псевдоним не найден для исходного имени параметра, он всегда будет иметь значение Linux.
Больше не поддерживает псевдоним ClientIdAndSecret параметра ServicePrincipalIdAndSecret.
Значение NodeVmSetType по умолчанию изменяется с AvailabilitySetVirtualMachineScaleSets.
Значение NetworkPlugin по умолчанию изменяется с noneazure.

До

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 — EOL. В настоящее время клиентам рекомендуется создавать приложения-функции PowerShell 7.0.
Измените версию среды выполнения по умолчанию в Функциях 3 в приложениях-функциях Windows для PowerShell с версии 6.2 до 7.0, если RuntimeVersion параметр не указан.
Изменена версия среды выполнения по умолчанию в Функциях 3 в приложениях-функциях Windows и Linux для node с 10 по 12, если RuntimeVersion параметр не указан. Однако пользователи по-прежнему могут создавать приложения-функции Node 10, указывая -Runtime Node и -RuntimeVersion 10. Измените версию среды выполнения по умолчанию в Функциях 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