Guia de migração para Az 5.0.0

Artigo
03/05/2025

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

Guia de migração para Az 5.0.0
- Az.Aks
  - New-AzAksCluster
  - Set-AzAksCluster
- Az.ContainerRegistry
  - New-AzContainerRegistry
- Az.Functions
  - Get-AzFunctionApp
  - New-AzFunctionApp
- Az.KeyVault
  - New-AzKeyVault
  - Update-AzKeyVault
  - Get-AzKeyVaultSecret
- Az.ManagedServices
  - Get-AzManagedServicesDefinition
  - Novo-ServiçosGeridosAzAssignment
  - Remove-AzManagedServicesAssignment
  - Remove-AzManagedServicesDefinition
- Az.ResourceManager
  - Get-AzManagementGroupDeployment
  - Get-AzManagementGroupDeploymentOperation
  - Get-AzDeployment
  - Get-AzDeploymentOperation
  - Get-AzDeploymentWhatIfResult
  - Get-AzTenantDeployment
  - Get-AzTenantDeploymentOperation
  - New-AzManagementGroupDeployment
  - New-AzDeployment
  - New-AzTenantDeployment
  - Remove-AzManagementGroupDeployment
  - Remover Implantação Az
  - Remove-AzTenantDeployment
  - Save-AzManagementGroupDeploymentTemplate
  - Save-AzDeploymentTemplate
  - Save-AzTenantDeploymentTemplate
  - Comando "Stop-AzManagementGroupDeployment"
  - Stop-AzDeployment
  - Stop-AzTenantDeployment
  - Test-AzManagementGroupDeployment
  - Test-AzDeployment
  - Test-AzTenantDeployment
  - Get-AzResourceGroupDeployment
  - Get-AzResourceGroupDeploymentOperation
  - Get-AzResourceGroupDeploymentWhatIfResult
  - New-AzResourceGroupDeployment
  - Remove-AzResourceGroupDeployment
  - Save-AzResourceGroupDeploymentTemplate
  - Stop-AzResourceGroupDeployment
  - Test-AzResourceGroupDeployment
  - Get-AzManagementGroupDeploymentWhatIfResult
  - Get-AzTenantDeploymentWhatIfResult
- Az.Sql
  - Set-AzSqlServerActiveDirectoryAdministrator
- Az.Synapse
  - New-AzSynapseSqlPool
  - Update-AzSynapseSqlPool
- Az.Network
  - Aprove-AzPrivateEndpointConnection
  - Deny-AzPrivateEndpointConnection
  - Get-AzPrivateEndpointConnection
  - Remove-AzPrivateEndpointConnection
  - Set-AzPrivateEndpointConnection
  - New-AzNetworkWatcherConnectionMonitorEndpointObject

Az.Aks

New-AzAksCluster

Não suporta mais o parâmetro NodeOsType e nenhum alias foi encontrado para o nome do parâmetro original, ele sempre será Linux.
Não suporta mais o alias ClientIdAndSecret para o parâmetro ServicePrincipalIdAndSecret.
O valor padrão de NodeVmSetType é alterado de AvailabilitySet para VirtualMachineScaleSets.
O valor padrão de NetworkPlugin é alterado de none para azure.

Antes

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

Após

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

Set-AzAksCluster

Não suporta mais o alias ClientIdAndSecret para o parâmetro ServicePrincipalIdAndSecret.

Antes

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

Após

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

Az.ContainerRegistry

New-AzContainerRegistry

Não suporta mais 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

Após

Classic foi preterido e StorageAccountName foi removido, pois só funciona com o Classic Container Registry.

Az.Funções

Get-AzFunctionApp

Removido o parâmetro switch IncludeSlot de todos os conjuntos de parâmetros Get-AzFunctionApp, exceto um. O cmdlet agora oferece suporte à recuperação de slots de implantação nos resultados quando -IncludeSlot é especificado. Essa funcionalidade foi interrompida na versão anterior do cmdlet. No entanto, isso agora está corrigido.

New-AzFunctionApp

Corrigido -DisableApplicationInsights no New-AzFunctionApp para que nenhum projeto de Application Insights seja criado quando essa opção for especificada.
Removido o suporte para criar aplicativos de função do PowerShell 6.2 desde que o PowerShell 6.2 é EOL. A orientação atual para os clientes é criar aplicações de funções em PowerShell 7.0.
Alterada a versão padrão de tempo de execução na versão 3 do Functions no Windows para aplicações de funções PowerShell de 6.2 para 7.0 quando o parâmetro RuntimeVersion não está especificado.
Alterada a versão de tempo de execução padrão na versão 3 do Functions no Windows e Linux para aplicações de funções Node.js de 10 para 12 quando o parâmetro RuntimeVersion não esteja especificado. No entanto, os utilizadores ainda podem criar aplicações de funções Node 10 ao especificar -Runtime Node e -RuntimeVersion 10. Alterada a versão de tempo de execução padrão no Functions versão 3 no Linux para aplicativos de função Python de 3.7 para 3.8 quando o parâmetro RuntimeVersion não é especificado. No entanto, os usuários ainda podem criar aplicativos de função 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

Após

# 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 suporta mais 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

Após

A capacidade de atualizar a configuração de exclusão suave foi preterida no Az.KeyVault 3.0.0. Ler mais

Update-AzKeyVault

Não suporta mais o parâmetro EnableSoftDelete, SoftDeleteRetentionInDayse nenhum alias foi encontrado para o nome do parâmetro original.

Antes

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

Após

A capacidade de atualizar a configuração de exclusão suave foi preterida no Az.KeyVault 3.0.0. Ler mais

Get-AzKeyVaultSecret

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

Antes

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

Após

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Não suporta mais o parâmetro ResourceId e nenhum alias foi encontrado para o nome do parâmetro original.

Antes

Get-AzManagedServicesDefinition -ResourceId xxx

Após

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Não suporta mais o parâmetro RegistrationDefinitionName, RegistrationDefinitionResourceIde nenhum alias foi encontrado para o nome do parâmetro original.

Antes

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Após

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Não suporta mais o parâmetro Id, ResourceIde nenhum alias foi encontrado para o nome do parâmetro original.

Antes

Remove-AzManagedServicesAssignment -ResourceId xxx

Após

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Não suporta mais o parâmetro Id, ResourceIde nenhum alias foi encontrado para o nome do parâmetro original.

Antes

Remove-AzManagedServicesDefinition -ResourceId xxx

Após

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Não suporta mais 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