Guide de migration pour Az 6.0.0

Article
04/04/2024

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

Guide de migration pour Az 6.0.0

Versions de PowerShell prises en charge

En raison de CVE-2021-26701, Az 6 est pris en charge seulement sur les plateformes suivantes :

PowerShell 7.1 : version 7.1.3 ou ultérieure
PowerShell 7.0 : version 7.0.6 ou ultérieure
Windows PowerShell 5.1

Pour plus d’informations, reportez-vous au cycle de vie du support d’Azure PowerShell

Az.Accounts

`Connect-AzAccount`

Suppression des paramètres obsolètes ManagedServiceHostName, ManagedServicePort et ManagedServiceSecret.

Avant

Connect-AzAccount -Identity -ManagedServiceSecret $secret

Après

#To use customized MSI endpoint, please set environment variable MSI_ENDPOINT, e.g. "http://localhost:50342/oauth2/token"; to use customized MSI secret, please set environment variable MSI_SECRET.
Connect-AzAccount -Identity

Az.ContainerInstance

`New-AzContainerGroup`

Ne prend plus en charge les paramètres Image, RegistryCredential, AzureFileVolumeShareName, AzureFileVolumeAccountCredential, AzureFileVolumeMountPath, IdentityId, AssignIdentity, OsType, Cpu, MemoryInGB, IpAddressType, DnsNameLabel, Port, Command, EnvironmentVariable, RegistryServerDomain, et aucun alias n’a été trouvé pour le nom du paramètre d’origine.

Avant

PS C:\> New-AzContainerGroup -ResourceGroupName demo -Name mycontainer -Image nginx -OsType Linux -IpAddressType Public -Port @(8000)

ResourceGroupName        : demo
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {8000}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

Après

PS C:\> $port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
PS C:\> $port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP
PS C:\> $container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5 -Port @($port1, $port2)
PS C:\> $containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

Location Name    Type
-------- ----    ----
eastus   test-cg Microsoft.ContainerInstance/containerGroups

`Remove-AzContainerGroup`

L’applet de commande « Remove-AzContainerGroup » 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

PS C:\> Find-AzResource -ResourceGroupEquals MyResourceGroup -ResourceNameEquals MyContainer | Remove-AzContainerGroup

Après

PS C:\> Remove-AzContainerGroup -Name test-cg -ResourceGroupName test-rg

Location Name    Type
-------- ----    ----
eastus   test-cg Microsoft.ContainerInstance/containerGroups

`Get-AzContainerGroup`

L’applet de commande « Get-AzContainerGroup » 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

PS C:\> Find-AzResource -ResourceGroupEquals demo -ResourceNameEquals mycontainer | Get-AzContainerGroup

ResourceGroupName        : demo
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Succeeded
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {8000}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

Après

PS C:\> Get-AzContainerGroup

Location Name           Type
-------- ----           ----
eastus   bez-cg1         Microsoft.ContainerInstance/containerGroups
eastus   bez-cg2        Microsoft.ContainerInstance/containerGroups

`Get-AzContainerInstanceLog`

L’applet de commande « Get-AzContainerInstanceLog » ne prend plus en charge le paramètre « ResourceId » et aucun alias n’a été trouvé pour le nom du paramètre d’origine. L’applet de commande « Get-AzContainerInstanceLog » ne prend plus en charge le paramètre « Name » et aucun alias n’a été trouvé pour le nom du paramètre d’origine.

Avant

PS C:\> Get-AzContainerGroup -ResourceGroupName demo -Name mycontainer | Get-AzContainerInstanceLog

Log line 1.
Log line 2.
Log line 3.
Log line 4.

Après

PS C:\> Get-AzContainerInstanceLog -ContainerGroupName test-cg -ContainerName test-container -ResourceGroupName test-rg

Az.DesktopVirtualization

`New-AzWvdHostPool`

L’applet de commande « New-AzWvdHostPool » ne prend plus en charge le paramètre « SsoContext » et aucun alias n’a été trouvé pour le nom du paramètre d’origine.

`Expand-AzWvdMsixImage`

L’applet de commande « Expand-AzWvdMsixImage » ne prend plus en charge le type « Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri » pour le paramètre « MsixImageUri ».

Avant

$MsixImageUri = [Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri]::New()
Get-AzWvdDesktop -ResourceGroupName ResourceGroupName -ApplicationGroupName ApplicationGroupName -Name DesktopName | Expand-AzWvdMsixImage -MsixImageUri $MsixImageUri

Après

$MsixImageUri = [Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixImageUri]::New()
Get-AzWvdDesktop -ResourceGroupName ResourceGroupName -ApplicationGroupName ApplicationGroupName -Name DesktopName | Expand-AzWvdMsixImage -MsixImageUri $MsixImageUri

`New-AzWvdMsixPackage`

Le type d’élément pour le paramètre « PackageApplication » a été changé de « Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications » en « Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications ». Le type d’élément pour le paramètre « PackageDependency » a été changé de « Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies » en « Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies ».

Avant

PS C:\> $apps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications]::New())
PS C:\> $deps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies]::New())
PS C:\> New-AzWvdMsixPackage -FullName PackageFullName `
							-HostPoolName HostPoolName `
							-ResourceGroupName ResourceGroupName `
							-SubscriptionId SubscriptionId `
							-DisplayName displayname `
							-ImagePath imageURI `
							-IsActive:$false `
							-IsRegularRegistration:$false `
							-LastUpdated datelastupdated `
							-PackageApplication $apps `
							-PackageDependency $deps `
							-PackageFamilyName packagefamilyname `
							-PackageName packagename `
							-PackageRelativePath packagerelativepath `
							-Version packageversion `

Après

PS C:\> $apps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications]::New())
PS C:\> $deps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies]::New())
PS C:\> New-AzWvdMsixPackage -FullName PackageFullName `
							-HostPoolName HostPoolName `
							-ResourceGroupName ResourceGroupName `
							-SubscriptionId SubscriptionId `
							-DisplayName displayname `
							-ImagePath imageURI `
							-IsActive:$false `
							-IsRegularRegistration:$false `
							-LastUpdated datelastupdated `
							-PackageApplication $apps `
							-PackageDependency $deps `
							-PackageFamilyName packagefamilyname `
							-PackageName packagename `
							-PackageRelativePath packagerelativepath `
							-Version packageversion `

`Update-AzWvdHostPool`

L’applet de commande « Update-AzWvdHostPool » ne prend plus en charge le paramètre « SsoContext » et aucun alias n’a été trouvé pour le nom du paramètre d’origine.

Az.StreamAnalytics

`Get-AzStreamAnalyticsDefaultFunctionDefinition`

L’applet de commande « Get-AzStreamAnalyticsDefaultFunctionDefinition » ne prend plus en charge le paramètre « File » et aucun alias n’a été trouvé pour le nom du paramètre d’origine.

Avant

Get-AzStreamAnalyticsDefaultFunctionDefinition -ResourceGroupName "StreamAnalytics-Default-West-US" -JobName "StreamJob22" -File "C:\RetrieveDefaultDefinitionRequest.json" -Name "ScoreTweet"

Après

Get-AzStreamAnalyticsDefaultFunctionDefinition -ResourceGroupName azure-rg-test -JobName sajob-01-pwsh -Name mlsfunction-01 -BindingType Microsoft.MachineLearningServices -Endpoint "http://875da830-4d5f-44f1-b221-718a5f26a21d.eastus.azurecontainer.io/score"-UdfType Scalar
Input is specified in flattened parameters instead from the input file.

`New-AzStreamAnalyticsJob`

L’applet de commande « New-AzStreamAnalyticsJob » ne prend plus en charge le paramètre « File » et aucun alias n’a été trouvé pour le nom du paramètre d’origine.

Avant

New-AzStreamAnalyticsJob -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\JobDefinition.json"

Après

New-AzStreamAnalyticsJob -ResourceGroupName azure-rg-test -Name sajob-02-pwsh -Location westcentralus -SkuName Standard
Input is specified in flattened parameters instead from the input file.

`New-AzStreamAnalyticsTransformation`

L’applet de commande « New-AzStreamAnalyticsTransformation » ne prend plus en charge le paramètre « File » et aucun alias n’a été trouvé pour le nom du paramètre d’origine.

Avant

New-AzStreamAnalyticsTransformation -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\Transformation.json" -JobName "StreamingJob" -Name "StreamingJobTransform"

Après

New-AzStreamAnalyticsTransformation -ResourceGroupName azure-rg-test -JobName sajob-01-pwsh -Name tranf-01 -StreamingUnit 6 -Query "Select Id, Name from input-01"
Input is specified in flattened parameters instead from the input file.

Az.RecoveryServices

`Set-AzRecoveryServicesBackupProperty`

Suppression de l’alias pluriel Set-AzRecoveryServicesBackupProperties, utilisation du nom de l’applet de commande Set-AzRecoveryServicesBackupProperty à l’avenir

`Get-AzRecoveryServicesBackupJobDetail`

Suppression de l’alias pluriel Get-AzRecoveryServicesBackupJobDetails, utilisation du nom de l’applet de commande Get-AzRecoveryServicesBackupJobDetail à l’avenir

Avant

$jobDetails = Get-AzRecoveryServicesBackupJobDetails -VaultId $vault.ID -Job $job
$jobDetails2 = Get-AzRecoveryServicesBackupJobDetails -VaultId $vault.ID -JobId $job.JobId

Après

$jobDetails = Get-AzRecoveryServicesBackupJobDetail -VaultId $vault.ID -Job $job
$jobDetails2 = Get-AzRecoveryServicesBackupJobDetail -VaultId $vault.ID -JobId $job.JobId

Az.Storage

`Remove-AzRmStorageShare`

L’applet de commande « Remove-AzRmStorageShare » peut supprimer un partage avec des instantanés par défaut avant le changement ; mais après le changement, la suppression de partage avec des instantanés va échouer par défaut, il faut ajouter le paramètre « -Include Snapshots » pour que la suppression réussisse.

Avant

Remove-AzRmStorageShare -ResourceGroupName $resourceGroupName -StorageAccountName $accountName -Name $shareName

Après

Remove-AzRmStorageShare -ResourceGroupName $resourceGroupName -StorageAccountName $accountName -Name $shareName -Force -Include Snapshots

Az.ServiceFabric

`Add-AzServiceFabricClusterCertificate`

Cette applet de commande a été supprimée complètement. Suivez les instructions données ici pour ajouter des certificats de cluster.

`Get-AzServiceFabricManagedClusterService`

Changement du modèle PSManagedService pour empêcher l’utilisation du paramètre properties directement à partir du SDK. Toutes les propriétés se trouvent maintenant dans le premier niveau de l’objet. Suppression des paramètres dépréciés InstanceCloseDelayDuration, DropSourceReplicaOnMove et ServiceDnsName

Avant

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.Properties.ProvisioningState

Après

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.ProvisioningState

`New-AzServiceFabricManagedCluster`

Suppression du paramètre déprécié ReverseProxyEndpointPort.

`New-AzServiceFabricManagedClusterService`

Avant

$service = New-AzServiceFabricManagedClusterService -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationName $appName -Name $serviceName -Type $serviceTypeName -Stateless -InstanceCount -1 -PartitionSchemaSingleton
$statelessService.Properties.ProvisioningState

Après

$service = New-AzServiceFabricManagedClusterService -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationName $appName -Name $serviceName -Type $serviceTypeName -Stateless -InstanceCount -1 -PartitionSchemaSingleton
$statelessService.ProvisioningState

`Remove-AzServiceFabricClusterCertificate`

Cette applet de commande a été supprimée complètement. Suivez les instructions données ici pour ajouter des certificats de cluster.

`Remove-AzServiceFabricManagedClusterService`

`Set-AzServiceFabricManagedCluster`

Suppression du paramètre déprécié ReverseProxyEndpointPort.

`Set-AzServiceFabricManagedClusterService`

Avant

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.Properties.MinInstanceCount = 3
service | Set-AzServiceFabricManagedClusterService

After

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.MinInstanceCount = 3
service | Set-AzServiceFabricManagedClusterService

Guide de migration pour Az 6.0.0

Versions de PowerShell prises en charge

Az.Accounts

Connect-AzAccount

Avant

Après

Az.ContainerInstance

New-AzContainerGroup

Avant

Après

Remove-AzContainerGroup

Avant

Après

Get-AzContainerGroup

Avant

Après

Get-AzContainerInstanceLog

Avant

Après

Az.DesktopVirtualization

New-AzWvdHostPool

Expand-AzWvdMsixImage

Avant

Après

New-AzWvdMsixPackage

Avant

Après

Update-AzWvdHostPool

Az.StreamAnalytics

Get-AzStreamAnalyticsDefaultFunctionDefinition

Avant

Après

New-AzStreamAnalyticsJob

Avant

Après

New-AzStreamAnalyticsTransformation

Avant

Après

Az.RecoveryServices

Set-AzRecoveryServicesBackupProperty

Get-AzRecoveryServicesBackupJobDetail

Avant

Après

Az.Storage

Remove-AzRmStorageShare

Avant

Après

Az.ServiceFabric

Add-AzServiceFabricClusterCertificate

Get-AzServiceFabricManagedClusterService

Avant

Après

New-AzServiceFabricManagedCluster

New-AzServiceFabricManagedClusterService

Avant

Après

Remove-AzServiceFabricClusterCertificate

Remove-AzServiceFabricManagedClusterService

Set-AzServiceFabricManagedCluster

Set-AzServiceFabricManagedClusterService

Avant

After

Commentaires

Ressources supplémentaires

`Connect-AzAccount`

`New-AzContainerGroup`

`Remove-AzContainerGroup`

`Get-AzContainerGroup`

`Get-AzContainerInstanceLog`

`New-AzWvdHostPool`

`Expand-AzWvdMsixImage`

`New-AzWvdMsixPackage`

`Update-AzWvdHostPool`

`Get-AzStreamAnalyticsDefaultFunctionDefinition`

`New-AzStreamAnalyticsJob`

`New-AzStreamAnalyticsTransformation`

`Set-AzRecoveryServicesBackupProperty`

`Get-AzRecoveryServicesBackupJobDetail`

`Remove-AzRmStorageShare`

`Add-AzServiceFabricClusterCertificate`

`Get-AzServiceFabricManagedClusterService`

`New-AzServiceFabricManagedCluster`

`New-AzServiceFabricManagedClusterService`

`Remove-AzServiceFabricClusterCertificate`

`Remove-AzServiceFabricManagedClusterService`

`Set-AzServiceFabricManagedCluster`

`Set-AzServiceFabricManagedClusterService`