Guide de migration pour Az 5.0.0

Ce document décrit les modifications entre les versions 4.0.0 et 5.0.0 d’Az.

Guide de migration pour Az 5.0.0

Az.Aks

New-AzAksCluster

Le paramètre NodeOsType n'est plus pris en charge et aucun alias n'a été trouvé pour le nom d'origine du paramètre, il sera toujours Linux.
Ne prend plus en charge l’alias ClientIdAndSecret pour le paramètre ServicePrincipalIdAndSecret.
La valeur par défaut de NodeVmSetType a été changée de AvailabilitySet à VirtualMachineScaleSets.
La valeur par défaut de NetworkPlugin a été changée 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 du paramètre d’origine.

Avant

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

Après

Classic a été déconseillé et StorageAccountName a été supprimé, car il fonctionne uniquement avec Classic Container Registry.

Az.Functions

Get-AzFunctionApp

Suppression du paramètre switch de tous les ensembles de paramètres, sauf un, de IncludeSlot. 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 version précédente de l’applet de commande. Toutefois, cela est maintenant résolu.

New-AzFunctionApp

Correction de -DisableApplicationInsights dans New-AzFunctionApp afin qu'aucun projet Application Insights ne soit créé lorsque cette option est sélectionnée.
Suppression de la prise en charge de la création d’applications de fonction PowerShell 6.2, car PowerShell 6.2 est EOL. Les conseils actuels pour les clients sont de créer des applications de fonction PowerShell 7.0 à la place.
Modification de la version du runtime par défaut dans Functions version 3 sur Windows pour les applications de fonction PowerShell de 6.2 à 7.0 lorsque le paramètre RuntimeVersion n’est pas spécifié.
Modification de la version du runtime par défaut dans Functions version 3 sur Windows et Linux pour les applications de fonction Node de 10 à 12 lorsque 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. Modification de la version par défaut du runtime dans Functions version 3 sur Linux pour les applications de fonctions Python de 3.7 à 3.8 lorsque 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 du 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 capacité de mettre à jour le paramètre du soft-delete est obsolète dans Az.KeyVault 3.0.0. En savoir plus

Update-AzKeyVault

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

Avant

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

Après

La capacité de mettre à jour le paramètre du soft-delete est obsolète 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 clair, ou utilisez un $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 du 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, RegistrationDefinitionResourceIdet aucun alias n’a été trouvé pour le nom du 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, ResourceIdet aucun alias n’a été trouvé pour le nom du 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, ResourceIdet aucun alias n’a été trouvé pour le nom du 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 du paramètre d’origine.

Avant

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