Migrationshandbuch für Az 6.0.0

In diesem Dokument werden die Änderungen zwischen den Versionen 5.0.0 und 6.0.0 von Az beschrieben.

Migrationshandbuch für Az 6.0.0

Unterstützte Versionen von PowerShell

Aufgrund von CVE-2021-26701 Az 6 wird nur auf den folgenden Plattformen unterstützt:

PowerShell 7.1: Version 7.1.3 oder höher
PowerShell 7.0: Version 7.0.6 oder höher
Windows PowerShell 5.1

Weitere Informationen finden Sie im Azure PowerShell Supportlebenszyklus

Az.Accounts

`Connect-AzAccount`

Veraltete Parameter ManagedServiceHostName, ManagedServicePort und ManagedServiceSecret entfernt.

Vorher

Connect-AzAccount -Identity -ManagedServiceSecret $secret

Nach

#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`

Unterstützt nicht länger die Parameter Image, RegistryCredential, AzureFileVolumeShareName, AzureFileVolumeAccountCredential, AzureFileVolumeMountPath, IdentityId, AssignIdentity, OsType, Cpu, MemoryInGB, IpAddressType, DnsNameLabel, Port, Command, EnvironmentVariable, RegistryServerDomain und es wurde kein Alias für den ursprünglichen Parameternamen gefunden.

Vorher

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                   : {}

Nach

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`

Das Cmdlet "Remove-AzContainerGroup" unterstützt nicht mehr den Parameter "ResourceId", und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Nach

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

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

`Get-AzContainerGroup`

Das Cmdlet "Get-AzContainerGroup" unterstützt nicht mehr den Parameter "ResourceId", und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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                   : {}

Nach

PS C:\> Get-AzContainerGroup

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

`Get-AzContainerInstanceLog`

Das Cmdlet "Get-AzContainerInstanceLog" unterstützt nicht mehr den Parameter "ResourceId", und für den ursprünglichen Parameternamen wurde kein Alias gefunden. Das Cmdlet "Get-AzContainerInstanceLog" unterstützt nicht mehr den Parameter "Name", und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

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

Nach

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

Az.DesktopVirtualization

`New-AzWvdHostPool`

Das Cmdlet "New-AzWvdHostPool" unterstützt nicht mehr den Parameter "SsoContext", und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

`Expand-AzWvdMsixImage`

Das Cmdlet 'Expand-AzWvdMsixImage' unterstützt den Typ 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri' für den Parameter 'MsixImageUri' nicht mehr.

Vorher

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

Nach

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

`New-AzWvdMsixPackage`

Der Elementtyp für den Parameter 'PackageApplication' wurde von 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications' zu 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications' geändert. Der Elementtyp für den Parameter 'PackageDependency' wurde von 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies' auf 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies' geändert.

Vorher

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 `

Nach

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`

Das Cmdlet 'Update-AzWvdHostPool' unterstützt den Parameter 'SsoContext' nicht mehr, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Az.StreamAnalytics

`Get-AzStreamAnalyticsDefaultFunctionDefinition`

Das Cmdlet "Get-AzStreamAnalyticsDefaultFunctionDefinition" unterstützt nicht mehr den Parameter "File", und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Nach

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`

Das Cmdlet "New-AzStreamAnalyticsJob" unterstützt nicht mehr den Parameter "File", und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Nach

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`

Das Cmdlet "New-AzStreamAnalyticsTransformation" unterstützt nicht mehr den Parameter "File", und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Nach

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`

Entfernt den Pluralalias von Set-AzRecoveryServicesBackupProperties; verwenden Sie zukünftig den Cmdlet-Namen Set-AzRecoveryServicesBackupProperty.

`Get-AzRecoveryServicesBackupJobDetail`

Entfernt den Pluralalias Get-AzRecoveryServicesBackupJobDetails, verwenden Sie zukünftig den Cmdlet-Namen Get-AzRecoveryServicesBackupJobDetail.

Vorher

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

Nach

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

Az.Storage

`Remove-AzRmStorageShare`

Das Cmdlet "Remove-AzRmStorageShare" konnte Freigaben mit Momentaufnahmen standardmäßig entfernen; nach der Änderung schlägt das Entfernen von Freigaben mit Momentaufnahmen jedoch standardmäßig fehl, daher muss der Parameter "-Include Snapshots" hinzugefügt werden, um die Entfernung erfolgreich durchzuführen.

Vorher

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

Nach

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

Az.ServiceFabric

`Add-AzServiceFabricClusterCertificate`

Dieses Cmdlet wurde vollständig entfernt. Folgen Sie den Anweisungen hier , um Clusterzertifikate hinzuzufügen.

`Get-AzServiceFabricManagedClusterService`

Ändern Sie das PSManagedService-Modell, um die Verwendung des Eigenschaftenparameters direkt aus dem SDK zu vermeiden. Jetzt befinden sich alle Eigenschaften auf der ersten Ebene des Objekts. Und entfernen Veraltete Parameter InstanceCloseDelayDuration, DropSourceReplicaOnMove und ServiceDnsName

Vorher

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

Nach

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

`New-AzServiceFabricManagedCluster`

Entfernt veralteten Parameter ReverseProxyEndpointPort.

`New-AzServiceFabricManagedClusterService`

Vorher

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

Nach

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

`Remove-AzServiceFabricClusterCertificate`

Dieses Cmdlet wurde vollständig entfernt. Folgen Sie den Anweisungen hier , um Clusterzertifikate hinzuzufügen.

`Remove-AzServiceFabricManagedClusterService`

Ändern Sie das PSManagedService-Modell, um die Verwendung des Eigenschaftenparameters direkt aus dem SDK zu vermeiden. Jetzt befinden sich alle Eigenschaften auf der ersten Ebene des Objekts.

`Set-AzServiceFabricManagedCluster`

Entfernt veralteten Parameter ReverseProxyEndpointPort.

`Set-AzServiceFabricManagedClusterService`

Vorher

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

Nach

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

Feedback

War diese Seite hilfreich?

Last updated on 2026-06-03

Migrationshandbuch für Az 6.0.0

Unterstützte Versionen von PowerShell

Az.Accounts

Connect-AzAccount

Vorher

Nach

Az.ContainerInstance

New-AzContainerGroup

Vorher

Nach

Remove-AzContainerGroup

Vorher

Nach

Get-AzContainerGroup

Vorher

Nach

Get-AzContainerInstanceLog

Vorher

Nach

Az.DesktopVirtualization

New-AzWvdHostPool

Expand-AzWvdMsixImage

Vorher

Nach

New-AzWvdMsixPackage

Vorher

Nach

Update-AzWvdHostPool

Az.StreamAnalytics

Get-AzStreamAnalyticsDefaultFunctionDefinition

Vorher

Nach

New-AzStreamAnalyticsJob

Vorher

Nach

New-AzStreamAnalyticsTransformation

Vorher

Nach

Az.RecoveryServices

Set-AzRecoveryServicesBackupProperty

Get-AzRecoveryServicesBackupJobDetail

Vorher

Nach

Az.Storage

Remove-AzRmStorageShare

Vorher

Nach

Az.ServiceFabric

Add-AzServiceFabricClusterCertificate

Get-AzServiceFabricManagedClusterService

Vorher

Nach

New-AzServiceFabricManagedCluster

New-AzServiceFabricManagedClusterService

Vorher

Nach

Remove-AzServiceFabricClusterCertificate

Remove-AzServiceFabricManagedClusterService

Set-AzServiceFabricManagedCluster

Set-AzServiceFabricManagedClusterService

Vorher

Nach

Feedback

Zusätzliche Ressourcen

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