Migreringsguide för Az 5.0.0

Artikel
03/05/2025

Det här dokumentet beskriver ändringarna mellan versionerna 4.0.0 och 5.0.0 av Az.

Migreringsguide för Az 5.0.0

Az.Aks

New-AzAksCluster

Stöder inte längre parametern NodeOsType och inget alias hittades för det ursprungliga parameternamnet, det kommer alltid att vara Linux.
Stöder inte längre aliaset ClientIdAndSecret för parametern ServicePrincipalIdAndSecret.
Standardvärdet för NodeVmSetType ändras från AvailabilitySet till VirtualMachineScaleSets.
Standardvärdet för NetworkPlugin ändras från none till azure.

Före

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeOsType Linux -ClientIdAndSecret xxx

Efter

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NodeVmSetType AvailabilitySet  -ServicePrincipalIdAndSecret xxx

Set-AzAksCluster

Stöder inte längre aliaset ClientIdAndSecret för parametern ServicePrincipalIdAndSecret.

Före

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ClientIdAndSecret xxx

Efter

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ServicePrincipalIdAndSecret xxx

Az.ContainerRegistry

New-AzContainerRegistry

Stöder inte längre parametern StorageAccountName och inget alias hittades för det ursprungliga parameternamnet.

Före

New-AzContainerRegistry -Name $name -ResourceGroupName $rg -Location $location -SKU Classic -StorageAccountName $storage

Efter

Classic är inaktuell och StorageAccountName har tagits bort eftersom det bara fungerar med klassiska containerregister.

Az.Functions

Get-AzFunctionApp

Tog bort IncludeSlot växelparameter från alla utom en parameteruppsättning av Get-AzFunctionApp. Cmdleten stöder nu hämtning av distributionsplatser i resultatet när -IncludeSlot har angetts. Den här funktionen bröts i den tidigare cmdlet-versionen. Detta är dock nu åtgärdat.

New-AzFunctionApp

Korrigerade -DisableApplicationInsights i New-AzFunctionApp så att inget application insights-projekt skapas när det här alternativet anges.
Stöd har tagits bort för att skapa PowerShell 6.2-funktionsappar eftersom PowerShell 6.2 är EOL. Den aktuella vägledningen för kunder är att skapa PowerShell 7.0-funktionsappar i stället.
Standardruntimeversionen ändrades i Functions version 3 på Windows för PowerShell-funktionsappar från 6.2 till 7.0 om parametern RuntimeVersion inte har angetts.
Standardversionen av körningen har ändrats i Functions version 3 i Windows och Linux för Node-funktionsappar från 10 till 12 när parametern RuntimeVersion inte har angetts. Användare kan dock fortfarande skapa Nod 10-funktionsappar genom att ange -Runtime Node och -RuntimeVersion 10. Standardkörningsversionen har ändrats i version 3 av Functions på Linux för Python-funktionsappar från 3.7 till 3.8 när parametern RuntimeVersion inte har angetts. Användare kan dock fortfarande skapa Python 3.7-funktionsappar genom att ange -Runtime Python och -RuntimeVersion 3.7.

Före

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python

Efter

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node `
                  -RuntimeVersion 10

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python `
                  -RuntimeVersion 3.7

Az.KeyVault

New-AzKeyVault

Stöder inte längre parametern DisableSoftDelete och inget alias hittades för det ursprungliga parameternamnet.

Före

# Opt out soft delete while creating a key vault
New-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -Location 'East US' -DisableSoftDelete

Efter

Möjligheten att uppdatera inställningen för mjuk borttagning är inaktuell i Az.KeyVault 3.0.0. Läs mer

Update-AzKeyVault

Stöder inte längre parametern EnableSoftDelete, SoftDeleteRetentionInDaysoch inget alias hittades för det ursprungliga parameternamnet.

Före

Update-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -EnableSoftDelete -SoftDeleteRetentionInDays 15

Efter

Möjligheten att uppdatera inställningen för mjuk borttagning är inaktuell i Az.KeyVault 3.0.0. Läs mer

Get-AzKeyVaultSecret

Egenskapen SecretValueText av typen Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret har tagits bort. Använd antingen en -AsPlainText för anropet för att hämta hemligheten med oformaterad text eller använd $secret.SecretValue av typen SecureString i skriptet.

Före

$secret = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret
$secretInPlainText = $secret.SecretValueText

Efter

$secretInPlainText = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret -AsPlainText

Az.ManagedServices

Get-AzManagedServicesDefinition

Stöder inte längre parametern ResourceId och inget alias hittades för det ursprungliga parameternamnet.

Före

Get-AzManagedServicesDefinition -ResourceId xxx

Efter

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Stöder inte längre parametern RegistrationDefinitionName, RegistrationDefinitionResourceIdoch inget alias hittades för det ursprungliga parameternamnet.

Före

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Efter

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Stöder inte längre parametern Id, ResourceIdoch inget alias hittades för det ursprungliga parameternamnet.

Före

Remove-AzManagedServicesAssignment -ResourceId xxx

Efter

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Stöder inte längre parametern Id, ResourceIdoch inget alias hittades för det ursprungliga parameternamnet.

Före

Remove-AzManagedServicesDefinition -ResourceId xxx

Efter

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Stöder inte längre parametern ApiVersion och inget alias hittades för det ursprungliga parameternamnet.

Före

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx -ApiVersion xxx