Guía de migración de Az 5.0.0

Artículo
05/03/2024

En este documento se describen los cambios existentes entre las versiones 4.0.0 y 5.0.0 de Az.

Guía de migración de Az 5.0.0

Az.Aks

New-AzAksCluster

Ya no admite el parámetro NodeOsType y no se ha encontrado ningún alias para el nombre de parámetro original, siempre será Linux.
Ya no admite el alias ClientIdAndSecret para el parámetro ServicePrincipalIdAndSecret.
El valor predeterminado de NodeVmSetType cambia de AvailabilitySet a VirtualMachineScaleSets.
El valor predeterminado de NetworkPlugin cambia de none a azure.

Antes

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

Después

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

Set-AzAksCluster

Ya no admite el alias ClientIdAndSecret para el parámetro ServicePrincipalIdAndSecret.

Antes

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

Después

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

Az.ContainerRegistry

New-AzContainerRegistry

Ya no admite el parámetro StorageAccountName y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

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

Después

Classic quedó en desuso y StorageAccountName se eliminó, ya que solo funciona con la versión clásica de Container Registry.

Az.Functions

Get-AzFunctionApp

Se ha quitado el parámetro del modificador IncludeSlot en todos los conjuntos de parámetros de Get-AzFunctionApp, menos en uno. El cmdlet ahora admite la recuperación de ranuras de implementación en los resultados cuando se especifica -IncludeSlot . Esta funcionalidad se interrumpió en la versión anterior del cmdlet. Sin embargo, ya se ha solucionado.

New-AzFunctionApp

Se corrigió -DisableApplicationInsights en New-AzFunctionApp, con el fin de que no se cree ningún proyecto de Application Insights cuando se especifique esta opción.
Se eliminó la compatibilidad para crear aplicaciones de funciones de PowerShell 6.2, ya que PowerShell 6.2 está en EOL. Las instrucciones que se da actualmente a los clientes es crear aplicaciones de funciones de PowerShell 7.0.
Se ha cambiado la versión predeterminada del runtime en la versión 3 de Functions en Windows para las aplicaciones de funciones de PowerShell, de la 6.2 a la 7.0, cuando no se especifica el parámetro RuntimeVersion.
Se ha cambiado la versión predeterminada del runtime en la versión 3 de Functions en Windows y Linux para las aplicaciones de funciones de Node, de la 10 a la 12, cuando no se especifica el parámetro RuntimeVersion. Sin embargo, los usuarios aún pueden crear aplicaciones de función de la versión 10 de Node. Para ello, deben especificar -Runtime Node y -RuntimeVersion 10. Se ha cambiado la versión predeterminada del runtime en la versión 3 de Functions Linux para las aplicaciones de funciones de Python, de la 3.7 a la 3.8, cuando no se especifica el parámetro RuntimeVersion. Sin embargo, los usuarios aún pueden crear aplicaciones de función de la versión 3.7 de Python. Para ello, deben especificar -Runtime Python y -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

Despué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

Ya no admite el parámetro DisableSoftDelete y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

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

Después

La capacidad para actualizar el valor de eliminación temporal está en desuso en Az.KeyVault 3.0.0. Más información

Update-AzKeyVault

Ya no admite el parámetro EnableSoftDelete, SoftDeleteRetentionInDays y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

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

Después

La capacidad para actualizar el valor de eliminación temporal está en desuso en Az.KeyVault 3.0.0. Más información

Get-AzKeyVaultSecret

Se ha quitado la propiedad SecretValueText de tipo Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret. Aplique el parámetro -AsPlainText a la llamada para obtener el secreto en texto sin formato o use un elemento $secret.SecretValue de tipo SecureString en el script.

Antes

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

Después

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Ya no admite el parámetro ResourceId y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

Get-AzManagedServicesDefinition -ResourceId xxx

Después

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Ya no admite el parámetro RegistrationDefinitionName, RegistrationDefinitionResourceId y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Después

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Ya no admite el parámetro Id, ResourceId y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

Remove-AzManagedServicesAssignment -ResourceId xxx

Después

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Ya no admite el parámetro Id, ResourceId y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

Remove-AzManagedServicesDefinition -ResourceId xxx

Después

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Ya no admite el parámetro ApiVersion y no se ha encontrado ningún alias para el nombre de parámetro original.

Antes

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