Migrationsleitfaden 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.

• Migrationsleitfaden für Az 6.0.0
  • Unterstützte Versionen von PowerShell
  • Az.Accounts
    • Connect-AzAccount
  • Az.ContainerInstance
    • New-AzContainerGroup
    • Remove-AzContainerGroup
    • Get-AzContainerGroup
    • Get-AzContainerInstanceLog
  • Az.DesktopVirtualization
    • New-AzWvdHostPool
    • Expand-AzWvdMsixImage
    • New-AzWvdMsixPackage
    • Update-AzWvdHostPool
  • Az.StreamAnalytics
    • Get-AzStreamAnalyticsDefaultFunctionDefinition
    • New-AzStreamAnalyticsJob
    • New-AzStreamAnalyticsTransformation
  • Az.RecoveryServices
    • Set-AzRecoveryServicesBackupProperty
    • Get-AzRecoveryServicesBackupJobDetail
  • Az.Storage
    • Remove-AzRmStorageShare
  • Az.ServiceFabric
    • Add-AzServiceFabricClusterCertificate
    • Get-AzServiceFabricManagedClusterService
    • New-AzServiceFabricManagedCluster
    • New-AzServiceFabricManagedClusterService
    • Remove-AzServiceFabricClusterCertificate
    • Remove-AzServiceFabricManagedClusterService
    • Set-AzServiceFabricManagedCluster
    • Set-AzServiceFabricManagedClusterService

Unterstützte Versionen von PowerShell

Wegen CVE-2021-26701 ist Az 6 nur auf den folgenden Plattformen verfügbar:

• 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 Details finden Sie im Azure PowerShell-Supportlebenszyklus

Az.Accounts

Connect-AzAccount

Veraltete Parameter ManagedServiceHostName, ManagedServicePort und ManagedServiceSecret entfernt.

Vorher

Connect-AzAccount -Identity -ManagedServiceSecret $secret

Nachher

#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 mehr den 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                   : {}

Nachher

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

Nachher

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

Nachher

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.

Nachher

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

Vom Cmdlet „Expand-AzWvdMsixImage“ wird der Typ „Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri“ für den Parameter „MsixImageUri“ nicht mehr unterstützt.

Vorher

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

Nachher

$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“ in „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“ in „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 `

Nachher

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"

Nachher

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"

Nachher

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"

Nachher

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

Der Pluralalias „Set-AzRecoveryServicesBackupProperties“ wurde entfernt, und ab sofort wird der Cmdlet-Name „Set-AzRecoveryServicesBackupProperty“ verwendet.

Get-AzRecoveryServicesBackupJobDetail

Der Pluralalias „Get-AzRecoveryServicesBackupJobDetails“ wurde entfernt, und ab sofort wird der Cmdlet-Name „Get-AzRecoveryServicesBackupJobDetail“ verwendet.

Vorher

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

Nachher

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

Az.Storage

Remove-AzRmStorageShare

Mit dem Cmdlet „Remove-AzRmStorageShare“ konnte bisher standardmäßig eine Freigabe mit Momentaufnahmen entfernt werden. Nach der Änderung tritt beim Entfernen von Freigaben mit Momentaufnahmen ein Fehler auf. Der Parameter „-Include Snapshots“ muss hinzugefügt werden, damit das Entfernen erfolgreich ist.

Vorher

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

Nachher

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 direkte Verwendung des Properties-Parameters aus dem SDK zu vermeiden. Jetzt befinden sich alle Eigenschaften auf der ersten Ebene des Objekts. Entfernen Sie die veralteten Parameter InstanceCloseDelayDuration, DropSourceReplicaOnMove und ServiceDnsName

Vorher

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

Nachher

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

New-AzServiceFabricManagedCluster

Entfernt veralteten Parameter ReverseProxyEndpointPort.

New-AzServiceFabricManagedClusterService

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

Vorher

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

Nachher

$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 Parameters „properties“ 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

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

Vorher

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

Nachher

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