Partager via


Guide de migration pour Az 6.0.0

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

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

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 = 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

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.

Set-AzServiceFabricManagedCluster

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

Set-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.MinInstanceCount = 3
service | Set-AzServiceFabricManagedClusterService

After

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