Migrationshandbuch für Az 5.0.0

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

Migrationshandbuch 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 Linuximmer .
Unterstützt den Alias ClientIdAndSecret für parameter ServicePrincipalIdAndSecretnicht mehr.
Der Standardwert von NodeVmSetType wird von AvailabilitySet zu VirtualMachineScaleSets geändert.
Der Standardwert von NetworkPlugin wird von none zu azure geändert.

Vorher

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

Nach

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

Set-AzAksCluster

Unterstützt den Alias ClientIdAndSecret für parameter ServicePrincipalIdAndSecretnicht mehr.

Vorher

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

Nach

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

Az.ContainerRegistry

New-AzContainerRegistry

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

Vorher

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

Nach

Classic ist veraltet, und StorageAccountName wurde entfernt, da es nur mit der klassischen Containerregistrierung funktioniert.

Az.Functions

Get-AzFunctionApp

Entfernt den IncludeSlot-Switch-Parameter aus allen Parametersätzen außer einem von Get-AzFunctionApp. Das Cmdlet unterstützt jetzt, dass Bereitstellungs-Slots in den Ergebnissen abgerufen werden, wenn -IncludeSlot angegeben ist. Diese Funktionalität wurde in der vorherigen Cmdlet-Version beschädigt. Dies wurde jedoch behoben.

New-AzFunctionApp

-DisableApplicationInsights wurde in New-AzFunctionApp so behoben, dass kein Application Insights-Projekt erstellt wird, wenn diese Option angegeben ist.
Unterstützung zum Erstellen von PowerShell 6.2-Funktions-Apps wurde entfernt, da PowerShell 6.2 EOL ist. Die aktuelle Anleitung für Kunden besteht darin, stattdessen PowerShell 7.0-Funktions-Apps zu erstellen.
Die standardmäßige Laufzeitversion für PowerShell-Funktions-Apps in Funktionen Version 3 unter Windows wurde von 6.2 auf 7.0 geändert, wenn der Parameter RuntimeVersion nicht angegeben ist.
Die Standardlaufzeitversion in Funktionen Version 3 unter Windows und Linux wurde für Node-Funktions-Apps von 10 auf 12 geändert, wenn der Parameter RuntimeVersion nicht angegeben ist. Benutzer können jedoch weiterhin Node 10-Funktions-Apps erstellen, indem sie angeben -Runtime Node und -RuntimeVersion 10. In Version 3 der Functions-Laufzeitumgebung auf Linux wurde die Standardlaufzeitversion von Python-Funktions-Apps von 3.7 auf 3.8 geändert, wenn der Parameter RuntimeVersion nicht angegeben ist. Benutzer können jedoch 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

Nach

# 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

Unterstützt den Parameter DisableSoftDelete nicht mehr, 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

Nach

Die Möglichkeit zum Aktualisieren der Soft-Delete-Einstellung ist in Az.KeyVault 3.0.0 veraltet. Mehr lesen

Update-AzKeyVault

Unterstützt nicht mehr den Parameter EnableSoftDelete, SoftDeleteRetentionInDaysund für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

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

Nach

Die Möglichkeit zum Aktualisieren der Soft-Delete-Einstellung ist in Az.KeyVault 3.0.0 veraltet. Mehr lesen

Get-AzKeyVaultSecret

Die Eigenschaft SecretValueText vom Typ Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret wurde entfernt. Wenden Sie entweder einen -AsPlainText auf den Aufruf an, um das Klartext-Geheimnis abzurufen, oder verwenden Sie $secret.SecretValue vom Typ SecureString in Ihrem Skript.

Vorher

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

Nach

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

Az.ManagedServices

Get-AzManagedServicesDefinition

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

Vorher

Get-AzManagedServicesDefinition -ResourceId xxx

Nach

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Unterstützt nicht mehr den Parameter RegistrationDefinitionName, RegistrationDefinitionResourceIdund für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Nach

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Unterstützt nicht mehr den Parameter Id, ResourceIdund für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

Remove-AzManagedServicesAssignment -ResourceId xxx

Nach

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Unterstützt nicht mehr den Parameter Id, ResourceIdund für den ursprünglichen Parameternamen wurde kein Alias gefunden.

Vorher

Remove-AzManagedServicesDefinition -ResourceId xxx

Nach

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

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

Vorher

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