Guide de migration pour Az 5.0.0

Article
04/04/2024

Ce document décrit les changements apportés entre les versions 4.0.0 et 5.0.0 d’Az.

Guide de migration pour Az 5.0.0

Az.Aks

New-AzAksCluster

Ne prend plus en charge le paramètre NodeOsType et aucun alias n’a été trouvé pour le nom de paramètre d’origine. Sera toujours Linux.
Ne prend plus en charge l’alias ClientIdAndSecret pour le paramètre ServicePrincipalIdAndSecret.
La valeur par défaut de NodeVmSetType passe de AvailabilitySet à VirtualMachineScaleSets.
La valeur par défaut de NetworkPlugin passe de none à azure.

Avant

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

Après

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

Set-AzAksCluster

Ne prend plus en charge l’alias ClientIdAndSecret pour le paramètre ServicePrincipalIdAndSecret.

Avant

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

Après

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

Az.ContainerRegistry

New-AzContainerRegistry

Ne prend plus en charge le paramètre StorageAccountName et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

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

Après

Classic a été déprécié et StorageAccountName a été supprimé car il fonctionne uniquement avec un registre de conteneurs classique.

Az.Functions

Get-AzFunctionApp

Suppression du paramètre booléen IncludeSlot de tous les jeux de paramètres de Get-AzFunctionApp sauf un. L’applet de commande prend désormais en charge la récupération des emplacements de déploiement dans les résultats quand -IncludeSlot est spécifié. Cette fonctionnalité a été interrompue dans la précédente version de l’applet de commande. Cependant, cela est maintenant résolu.

New-AzFunctionApp

Correction de -DisableApplicationInsights dans New-AzFunctionApp afin qu’aucun projet Application Insights ne soit créé quand cette option est spécifiée.
Suppression de la prise en charge de la création d’applications de fonction PowerShell 6.2, car PowerShell 6.2 arrive en fin de vie. Le conseil actuel pour les clients est de créer des applications de fonction PowerShell 7.0 à la place.
Changement de la version du runtime par défaut dans Functions version 3 sur Windows pour les applications de fonction PowerShell de 6.2 en 7.0 quand le paramètre RuntimeVersion n’est pas spécifié.
Changement de la version du runtime par défaut dans Functions version 3 sur Windows et Linux pour les applications de fonction Node de 10 en 12 quand le paramètre RuntimeVersion n’est pas spécifié. Toutefois, les utilisateurs peuvent toujours créer des applications de fonction Node 10 en spécifiant -Runtime Node et -RuntimeVersion 10. Changement de la version du runtime par défaut dans Functions version 3 sur Linux pour les applications de fonction Python de 3.7 en 3.8 quand le paramètre RuntimeVersion n’est pas spécifié. Toutefois, les utilisateurs peuvent toujours créer des applications de fonction Python 3.7 en spécifiant -Runtime Python et -RuntimeVersion 3.7.

Avant

# 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

Aprè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

Ne prend plus en charge le paramètre DisableSoftDelete et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

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

Après

La possibilité de mettre à jour le paramètre de suppression réversible est dépréciée dans Az.KeyVault 3.0.0. En savoir plus

Update-AzKeyVault

Ne prend plus en charge le paramètre EnableSoftDelete, SoftDeleteRetentionInDays, et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

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

Après

La possibilité de mettre à jour le paramètre de suppression réversible est dépréciée dans Az.KeyVault 3.0.0. En savoir plus

Get-AzKeyVaultSecret

La propriété SecretValueText de type Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret a été supprimée. Appliquez un -AsPlainText à l’appel pour obtenir le secret en texte brut, ou utilisez $secret.SecretValue de type SecureString dans votre script.

Avant

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

Après

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Ne prend plus en charge le paramètre ResourceId et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

Get-AzManagedServicesDefinition -ResourceId xxx

Après

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Ne prend plus en charge le paramètre RegistrationDefinitionName, RegistrationDefinitionResourceId, et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Après

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Ne prend plus en charge le paramètre Id, ResourceId, et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

Remove-AzManagedServicesAssignment -ResourceId xxx

Après

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Ne prend plus en charge le paramètre Id, ResourceId, et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

Remove-AzManagedServicesDefinition -ResourceId xxx

Après

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Ne prend plus en charge le paramètre ApiVersion et aucun alias n’a été trouvé pour le nom de paramètre d’origine.

Avant

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