Guia de Migração para o Az 5.0.0

Artigo
05/21/2024

Este documento descreverá as alterações do Az entre as versões 4.0.0 e 5.0.0.

Guia de Migração para o Az 5.0.0

Az.Aks

New-AzAksCluster

Não é mais compatível com o parâmetro NodeOsType. Além disso, nenhum alias foi encontrado para o nome do parâmetro original. Ele sempre será Linux.
Não é mais compatível com o alias ClientIdAndSecret para o parâmetro ServicePrincipalIdAndSecret.
O valor padrão de NodeVmSetType foi alterado de AvailabilitySet para VirtualMachineScaleSets.
O valor padrão de NetworkPlugin foi alterado de none para azure.

Antes

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

Depois

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

Set-AzAksCluster

Não é mais compatível com o alias ClientIdAndSecret para o parâmetro ServicePrincipalIdAndSecret.

Antes

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

Depois

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

Az.ContainerRegistry

New-AzContainerRegistry

Não é mais compatível com o parâmetro StorageAccountName e nenhum alias foi encontrado para o nome do parâmetro original.

Antes

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

Depois

Classic foi preterido e StorageAccountName foi removido, pois ele só funcionava com um Registro de Contêiner Clássico.

Az.Functions

Get-AzFunctionApp

Remoção do parâmetro de opção IncludeSlot de todos os parâmetros, exceto de um conjunto de parâmetros de Get-AzFunctionApp. O cmdlet agora é compatível com a recuperação de slots de implantação nos resultados quando -IncludeSlot for especificado. Essa funcionalidade foi interrompida na versão anterior do cmdlet. No entanto, isso foi corrigido.

New-AzFunctionApp

Correção de -DisableApplicationInsights em New-AzFunctionApp para que nenhum projeto do Application Insights seja criado quando essa opção for especificada.
Remoção do suporte para criar aplicativos de funções do PowerShell 6.2, pois o PowerShell 6.2 é EOL. As diretrizes atuais para os clientes é criar aplicativos de funções do PowerShell 7.0 como alternativa.
Alteração da versão de runtime padrão da 6.2 para a 7.0 no Functions versão 3 no Windows para aplicativos de funções do PowerShell quando o parâmetro RuntimeVersion não for especificado.
Alteração da versão de runtime padrão da 10 para a 12 no Functions versão 3 no Windows e Linux para aplicativos de funções do Node quando o parâmetro RuntimeVersion não for especificado. No entanto, os usuários ainda poderão criar aplicativos de funções do Node 10 especificando -Runtime Node e -RuntimeVersion 10. Alteração da versão de runtime padrão da 3.7 para a 3.8 no Functions versão 3 no Linux para aplicativos de funções do Python quando o parâmetro RuntimeVersion não for especificado. No entanto, os usuários ainda poderão criar aplicativos de funções do Python 3.7 especificando -Runtime Python e -RuntimeVersion 3.7.

Antes

# 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

Depois

# 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

Não é mais compatível com o parâmetro DisableSoftDelete e nenhum alias foi encontrado para o nome do parâmetro original.

Antes

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

Depois

A capacidade de atualizar a configuração de exclusão reversível será preterida no Az.KeyVault 3.0.0. Leia mais

Update-AzKeyVault

Não é mais compatível com os parâmetros EnableSoftDelete e SoftDeleteRetentionInDays. Além disso, nenhum alias foi encontrado para o nome do parâmetro original.

Antes

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

Depois

A capacidade de atualizar a configuração de exclusão reversível será preterida no Az.KeyVault 3.0.0. Leia mais

Get-AzKeyVaultSecret

A propriedade SecretValueText do tipo Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret foi removida. Aplique um -AsPlainText à chamada para receber o segredo de texto sem formatação ou use o $secret.SecretValue do tipo SecureString no script.

Antes

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

Depois

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Não é mais compatível com o parâmetro ResourceId e nenhum alias foi encontrado para o nome do parâmetro original.

Antes

Get-AzManagedServicesDefinition -ResourceId xxx

Depois

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Não é mais compatível com os parâmetros RegistrationDefinitionName e RegistrationDefinitionResourceId. Além disso, nenhum alias foi encontrado para o nome do parâmetro original.

Antes

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Depois

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Não é mais compatível com os parâmetros Id e ResourceId. Além disso, nenhum alias foi encontrado para o nome do parâmetro original.

Antes

Remove-AzManagedServicesAssignment -ResourceId xxx

Depois

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Não é mais compatível com os parâmetros Id e ResourceId. Além disso, nenhum alias foi encontrado para o nome do parâmetro original.

Antes

Remove-AzManagedServicesDefinition -ResourceId xxx

Depois

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Não é mais compatível com o parâmetro ApiVersion e nenhum alias foi encontrado para o nome do parâmetro original.

Antes

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