Migratiehandleiding voor Az 6.0.0

Artikel
03/05/2025

In dit document worden de wijzigingen tussen de versies 5.0.0 en 6.0.0 van Az beschreven.

migratiehandleiding voor Az 6.0.0

Ondersteunde versies van PowerShell

Vanwege CVE-2021-26701 Az 6 wordt alleen ondersteund op de volgende platforms:

PowerShell 7.1: versie 7.1.3 of hoger
PowerShell 7.0: versie 7.0.6 of hoger
Windows PowerShell 5.1

Raadpleeg de ondersteuningslevenscyclus van Azure PowerShell voor meer informatie

Az.Accounts

`Connect-AzAccount`

Verouderde parameters ManagedServiceHostName, ManagedServicePort en ManagedServiceSecret verwijderd.

Voor

Connect-AzAccount -Identity -ManagedServiceSecret $secret

Na

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

Ondersteunt niet langer de parameter Image, RegistryCredential, AzureFileVolumeShareName, AzureFileVolumeAccountCredential, AzureFileVolumeMountPath, IdentityId, AssignIdentity, OsType, Cpu, MemoryInGB, IpAddressType, DnsNameLabel, Port, Command, EnvironmentVariable, RegistryServerDomain en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Voor

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

Na

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`

De cmdlet Remove-AzContainerGroup ondersteunt de parameter ResourceId niet meer en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Voor

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

Na

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

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

`Get-AzContainerGroup`

De cmdlet Get-AzContainerGroup ondersteunt de parameter ResourceId niet meer en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Voor

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

Na

PS C:\> Get-AzContainerGroup

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

`Get-AzContainerInstanceLog`

De cmdlet 'Get-AzContainerInstanceLog' ondersteunt de parameter ResourceId niet meer en er is geen alias gevonden voor de oorspronkelijke parameternaam. De cmdlet 'Get-AzContainerInstanceLog' ondersteunt de parameter 'Name' niet meer en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Voor

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

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

Na

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

Az.DesktopVirtualization

`New-AzWvdHostPool`

De cmdlet 'New-AzWvdHostPool' biedt geen ondersteuning meer voor de parameter 'SsoContext' en er is geen alias gevonden voor de oorspronkelijke parameternaam.

`Expand-AzWvdMsixImage`

De cmdlet 'Expand-AzWvdMsixImage' ondersteunt niet langer het type 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri' voor de parameter 'MsixImageUri'.

Voor

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

Na

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

`New-AzWvdMsixPackage`

Het elementtype voor de parameter PackageApplication is gewijzigd van Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications in Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications. Het elementtype voor parameter 'PackageDependency' is gewijzigd van 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies' naar 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies'.

Voor

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 `

Na

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`

De cmdlet 'Update-AzWvdHostPool' biedt geen ondersteuning meer voor de parameter 'SsoContext' en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Az.StreamAnalytics

`Get-AzStreamAnalyticsDefaultFunctionDefinition`

De cmdlet 'Get-AzStreamAnalyticsDefaultFunctionDefinition' ondersteunt de parameter 'File' niet meer en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Voor

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

Na

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`

De cmdlet New-AzStreamAnalyticsJob biedt geen ondersteuning meer voor de parameter File en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Voor

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

Na

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`

De cmdlet 'New-AzStreamAnalyticsTransformation' biedt geen ondersteuning meer voor de parameter 'File' en er is geen alias gevonden voor de oorspronkelijke parameternaam.

Voor

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

Na

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`

Set-AzRecoveryServicesBackupProperties meervoudsalias is verwijderd, gebruik voortaan de Set-AzRecoveryServicesBackupProperty cmdlet-naam

`Get-AzRecoveryServicesBackupJobDetail`

Get-AzRecoveryServicesBackupJobDetails meervoudsalias is verwijderd, gebruik Get-AzRecoveryServicesBackupJobDetail cmdlet-naam in de toekomst

Voordat

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

Na

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

Az.Storage

`Remove-AzRmStorageShare`

De cmdlet 'Remove-AzRmStorageShare' kon voorheen standaard shares met momentopnamen verwijderen; maar na de wijziging zal het verwijderen van shares met momentopnamen standaard mislukken. Om het verwijderen te laten slagen, moet de parameter "-Include Snapshots" worden toegevoegd.

Voor

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

Na

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

Az.ServiceFabric

`Add-AzServiceFabricClusterCertificate`

deze cmdlet is volledig verwijderd. volg de instructies hier om clustercertificaten toe te voegen.

`Get-AzServiceFabricManagedClusterService`

Wijzig het PSManagedService-model om te voorkomen dat de parameter eigenschappen rechtstreeks vanuit de SDK wordt gebruikt. Nu bevinden alle eigenschappen zich op het eerste niveau van het object. En verwijder afgeschafte parameters InstanceCloseDelayDuration, DropSourceReplicaOnMove en ServiceDnsName

Voor

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

Na

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

`New-AzServiceFabricManagedCluster`

Verwijder de afgeschafte parameter ReverseProxyEndpointPort.

`New-AzServiceFabricManagedClusterService`

Voor

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

Na

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

`Remove-AzServiceFabricClusterCertificate`

deze cmdlet is volledig verwijderd. volg de instructies hier om clustercertificaten toe te voegen.

`Remove-AzServiceFabricManagedClusterService`

Wijzig het PSManagedService-model om te voorkomen dat de parameter eigenschappen rechtstreeks vanuit de SDK wordt gebruikt. Nu bevinden alle eigenschappen zich op het eerste niveau van het object.

`Set-AzServiceFabricManagedCluster`

Verwijder de afgeschafte parameter ReverseProxyEndpointPort.

`Set-AzServiceFabricManagedClusterService`

Voor

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

Na

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

Delen via

Migratiehandleiding voor Az 6.0.0

Ondersteunde versies van PowerShell

Az.Accounts

Connect-AzAccount

Voor

Na

Az.ContainerInstance

New-AzContainerGroup

Voor

Na

Remove-AzContainerGroup

Voor

Na

Get-AzContainerGroup

Voor

Na

Get-AzContainerInstanceLog

Voor

Na

Az.DesktopVirtualization

New-AzWvdHostPool

Expand-AzWvdMsixImage

Voor

Na

New-AzWvdMsixPackage

Voor

Na

Update-AzWvdHostPool

Az.StreamAnalytics

Get-AzStreamAnalyticsDefaultFunctionDefinition

Voor

Na

New-AzStreamAnalyticsJob

Voor

Na

New-AzStreamAnalyticsTransformation

Voor

Na

Az.RecoveryServices

Set-AzRecoveryServicesBackupProperty

Get-AzRecoveryServicesBackupJobDetail

Voordat

Na

Az.Storage

Remove-AzRmStorageShare

Voor

Na

Az.ServiceFabric

Add-AzServiceFabricClusterCertificate

Get-AzServiceFabricManagedClusterService

Voor

Na

New-AzServiceFabricManagedCluster

New-AzServiceFabricManagedClusterService

Voor

Na

Remove-AzServiceFabricClusterCertificate

Remove-AzServiceFabricManagedClusterService

Set-AzServiceFabricManagedCluster

Set-AzServiceFabricManagedClusterService

Voor

Na

Aanvullende resources

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