Migrationsleitfaden für Az 5.0.0

Artikel
04/04/2024

In diesem Dokument werden die Änderungen beschrieben, die zwischen den Versionen 4.0.0 und 5.0.0 von Az vorgenommen wurden.

Migrationsleitfaden für Az 5.0.0

Az.Aks

New-AzAksCluster

Der Parameter NodeOsType wird nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden. Er lautet immer Linux.
Der Alias ClientIdAndSecret für den Parameter ServicePrincipalIdAndSecret wird nicht mehr unterstützt.
Der Standardwert von NodeVmSetType wurde von AvailabilitySet in VirtualMachineScaleSets geändert.
Der Standardwert von NetworkPlugin wurde von none in azure geändert.

Vorher

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

Danach

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

Set-AzAksCluster

Der Alias ClientIdAndSecret für den Parameter ServicePrincipalIdAndSecret wird nicht mehr unterstützt.

Vorher

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

Danach

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

Az.ContainerRegistry

New-AzContainerRegistry

Der Parameter StorageAccountName wird nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Danach

Classic wurde als veraltet eingestuft, und der Parameter StorageAccountName wurde entfernt, da er nur mit der klassischen Containerregistrierung funktioniert.

Az.Functions

Get-AzFunctionApp

Der Switch-Parameter IncludeSlot wurde aus allen Parametersätzen von „Get-AzFunctionApp“ entfernt (bis auf einen). Das Cmdlet unterstützt jetzt das Abrufen von Bereitstellungsslots in den Ergebnissen, wenn -IncludeSlot angegeben ist. Diese Funktionalität war in der vorherigen Cmdlet-Version beschädigt. Der Fehler ist jetzt aber behoben.

New-AzFunctionApp

-DisableApplicationInsights wurde in New-AzFunctionApp korrigiert, damit bei Angabe dieser Option kein Application Insights-Projekt erstellt wird.
Die Unterstützung für die Erstellung von PowerShell 6.2-Funktions-Apps wurde entfernt, da für PowerShell 6.2 der EOL-Zeitpunkt erreicht wurde. Für Kunden wird derzeit empfohlen, stattdessen PowerShell 7.0-Funktions-Apps zu erstellen.
Es wurde festgelegt, dass in Functions-Version 3 von Windows für PowerShell-Funktions-Apps anstelle der Runtime-Standardversion 6.2 die Version 7.0 verwendet wird, wenn der Parameter RuntimeVersion nicht angegeben ist.
Es wurde festgelegt, dass in Functions-Version 3 von Windows/Linux für Node-Funktions-Apps anstelle der Runtime-Standardversion 10 die Version 12 verwendet wird, wenn der Parameter RuntimeVersion nicht angegeben ist. Benutzer können aber weiterhin Node 10-Funktions-Apps erstellen, indem sie -Runtime Node und -RuntimeVersion 10 angeben. Es wurde festgelegt, dass in Functions-Version 3 von Linux für Python-Funktions-Apps anstelle der Runtime-Standardversion 3.7 die Version 3.8 verwendet wird, wenn der Parameter RuntimeVersion nicht angegeben ist. Benutzer können aber weiterhin Python 3.7-Funktions-Apps erstellen, indem sie -Runtime Python und -RuntimeVersion 3.7 angeben.

Vorher

# 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

Danach

# 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

Der Parameter DisableSoftDelete wird nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Danach

Die Möglichkeit zum Aktualisieren der Einstellung für das vorläufige Löschen wurde in Az.KeyVault 3.0.0 als veraltet eingestuft. hier

Update-AzKeyVault

Die Parameter EnableSoftDelete und SoftDeleteRetentionInDays werden nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Danach

Die Möglichkeit zum Aktualisieren der Einstellung für das vorläufige Löschen wurde in Az.KeyVault 3.0.0 als veraltet eingestuft. hier

Get-AzKeyVaultSecret

Die SecretValueText-Eigenschaft vom Typ Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret wurde entfernt. Wenden Sie entweder -AsPlainText auf den Aufruf an, um das Nur-Text-Geheimnis zu erhalten, oder verwenden Sie $secret.SecretValue vom Typ SecureString im Skript.

Vorher

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

Danach

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Der Parameter ResourceId wird nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

Get-AzManagedServicesDefinition -ResourceId xxx

Danach

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Die Parameter RegistrationDefinitionName und RegistrationDefinitionResourceId werden nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Danach

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Die Parameter Id und ResourceId werden nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

Remove-AzManagedServicesAssignment -ResourceId xxx

Danach

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Die Parameter Id und ResourceId werden nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

Remove-AzManagedServicesDefinition -ResourceId xxx

Danach

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Der Parameter ApiVersion wird nicht mehr unterstützt, und für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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