Migreringsguide för Az 5.0.0

Artikel
07/09/2024

I det här dokumentet beskrivs ändringarna mellan Az-versionerna 4.0.0 och 5.0.0.

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, som alltid kommer att vara Linux.
Stöder inte längre aliaset ClientIdAndSecret för parametern ServicePrincipalIdAndSecret.
Standardvärdet för NodeVmSetType har ändrats från AvailabilitySet till VirtualMachineScaleSets.
Standardvärdet för NetworkPlugin har ändrats 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 den endast fungerar med klassiska Container Registry.

Az.Functions

Get-AzFunctionApp

Tog bort växelparametern IncludeSlot från alla förutom en parameteruppsättning av Get-AzFunctionApp. Cmdleten stöder nu hämtning av distributionsfack i resultaten när -IncludeSlot anges. Den här funktionen fungerade inte i den tidigare cmdlet-versionen. Detta är dock åtgärdat nu.

New-AzFunctionApp

Korrigerade -DisableApplicationInsights i New-AzFunctionApp så att inga Application Insights-projekt skapas när det här alternativet har angetts.
Tog bort stöd för att skapa PowerShell 6.2-funktionsappar eftersom PowerShell 6.2 är EOL. Vi rekommenderar för närvarande att kunder skapar PowerShell 7.0-funktionsappar i stället.
Ändrade körningsversionen som är standard i Functions version 3 i Windows för PowerShell-funktionsppar från 6.2 till 7.0 när parametern RuntimeVersion inte har angetts.
Ändrade körningsversionen som är standard i Functions version 3 i Windows och Linux för Node-funktionsppar från 10 till 12 när parametern RuntimeVersion inte har angetts. Användare kan dock fortfarande skapa Node 10-funktionsappar genom att ange -Runtime Node och -RuntimeVersion 10. Ändrade körningsversionen som är standard i Functions version 3 i Linux för Python-funktionsppar 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 parametrarna EnableSoftDelete, SoftDeleteRetentionInDays, och 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 ett -AsPlainText för anropet för att hämta oformaterad texthemlighet eller använda $secret.SecretValue 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 parametrarna RegistrationDefinitionName, RegistrationDefinitionResourceId, och 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 parametrarna Id, ResourceId, och 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 parametrarna Id, ResourceId, och 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