Freigeben über


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.

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 wird NodeVmSetType von AvailabilitySet zu VirtualMachineScaleSets.
  • Der Standardwert wird NetworkPlugin von none zu azure.

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 veraltet und StorageAccountName wurde entfernt, da sie nur mit der klassischen Containerregistrierung funktioniert.

Az.Functions

Get-AzFunctionApp

IncludeSlot Switch-Parameter aus allen außer einem Parametersatz entferntGet-AzFunctionApp. Das Cmdlet unterstützt jetzt das Abrufen von Bereitstellungsplätzen in den Ergebnissen, wenn -IncludeSlot angegeben. Diese Funktionalität wurde in der vorherigen Cmdlet-Version beschädigt. Dies wurde jedoch behoben.

New-AzFunctionApp

  • -DisableApplicationInsights Es wurde behobenNew-AzFunctionApp, sodass kein Anwendungserkenntnisse-Projekt erstellt wird, wenn diese Option angegeben wird.
  • 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 Standardlaufzeitversion in Funktionen, Version 3 für Windows für PowerShell-Funktions-Apps, wurde von 6.2 auf 7.0 geändert, wenn der RuntimeVersion Parameter nicht angegeben ist.
  • Die Standardlaufzeitversion in Funktionen Version 3 unter Windows und Linux für Node-Funktions-Apps wurde von 10 auf 12 geändert, wenn der RuntimeVersion Parameter nicht angegeben ist. Benutzer können jedoch weiterhin Node 10-Funktions-Apps erstellen, indem sie angeben -Runtime Node und -RuntimeVersion 10. Die Standardlaufzeitversion in Functions Version 3 unter Linux für Python-Funktions-Apps wurde von 3.7 auf 3.8 geändert, wenn der RuntimeVersion Parameter nicht angegeben ist. Benutzer können jedoch weiterhin Python 3.7-Funktions-Apps erstellen, indem sie angeben -Runtime Python und -RuntimeVersion 3.7.

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 Einstellung für das vorläufige Löschen 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 Einstellung für das vorläufige Löschen ist in Az.KeyVault 3.0.0 veraltet. Mehr lesen

Get-AzKeyVaultSecret

Die Eigenschaft SecretValueText des Typs Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret wurde entfernt. Wenden Sie entweder einen -AsPlainText auf den Aufruf an, um den reinen Textschlüssel abzurufen, oder verwenden Sie $secret.SecretValue den 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

Nach

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx

Get-AzManagementGroupDeploymentOperation

Identisch mit Get-AzManagementGroupDeployment.

Get-AzDeployment

Identisch mit Get-AzManagementGroupDeployment.

Get-AzDeploymentOperation

Identisch mit Get-AzManagementGroupDeployment.

Get-AzDeploymentWhatIfResult

Identisch mit Get-AzManagementGroupDeployment.

Get-AzTenantDeployment

Identisch mit Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentOperation

Identisch mit Get-AzManagementGroupDeployment.

New-AzManagementGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

New-AzDeployment

Identisch mit Get-AzManagementGroupDeployment.

New-AzTenantDeployment

Identisch mit Get-AzManagementGroupDeployment.

Remove-AzManagementGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Remove-AzDeployment

Identisch mit Get-AzManagementGroupDeployment.

Remove-AzTenantDeployment

Identisch mit Get-AzManagementGroupDeployment.

Save-AzManagementGroupDeploymentTemplate

Identisch mit Get-AzManagementGroupDeployment.

Save-AzDeploymentTemplate

Identisch mit Get-AzManagementGroupDeployment.

Save-AzTenantDeploymentTemplate

Identisch mit Get-AzManagementGroupDeployment.

Stop-AzManagementGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Stop-AzDeployment

Identisch mit Get-AzManagementGroupDeployment.

Stop-AzTenantDeployment

Identisch mit Get-AzManagementGroupDeployment.

Test-AzManagementGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Test-AzDeployment

Identisch mit Get-AzManagementGroupDeployment.

Test-AzTenantDeployment

Identisch mit Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentOperation

Identisch mit Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentWhatIfResult

Identisch mit Get-AzManagementGroupDeployment.

New-AzResourceGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Remove-AzResourceGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Save-AzResourceGroupDeploymentTemplate

Identisch mit Get-AzManagementGroupDeployment.

Stop-AzResourceGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Test-AzResourceGroupDeployment

Identisch mit Get-AzManagementGroupDeployment.

Get-AzManagementGroupDeploymentWhatIfResult

Identisch mit Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentWhatIfResult

Identisch mit Get-AzManagementGroupDeployment.

Az.Sql

Set-AzSqlServerActiveDirectoryAdministrator

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

Vorher

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -DisplayName 'DBAs' -IsAzureADOnlyAuthentication

Nach

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -DisplayName 'DBAs'

Az.Synapse

New-AzSynapseSqlPool

Der Parameter FromBackup, , FromRestorePoint, BackupResourceGroupNameBackupWorkspaceName, BackupSqlPoolName, , BackupSqlPoolObject, , BackupResourceId, , SourceResourceGroupName, SourceWorkspaceName, SourceSqlPoolNameSourceSqlPoolObjectSourceResourceId, , RestorePointwurde nicht mehr unterstützt, und es wurde kein Alias für den ursprünglichen Parameternamen gefunden.

Vorher

New-AzSynapseSqlPool -FromBackup -WorkspaceName ContosoWorkspace -Name ContosoSqlPool -BackupWorkspaceName ContosoWorkspace -BackupSqlPoolName ExistingContosoSqlPool

Nach

PS C:\> New-AzSynapseSqlPool -WorkspaceName ContosoWorkspace -Name ContosoSqlPool -PerformanceLevel DW200c

Update-AzSynapseSqlPool

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

Az.Network

Approve-AzPrivateEndpointConnection

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

Vorher

Approve-AzPrivateEndpointConnection -ResourceGroupName xxx -ServiceName xxx -Name xxx -PrivateLinkResourceType 'Microsoft.Network/privateLinkServices' -Description xxx

Nach

Approve-AzPrivateEndpointConnection -ResourceGroupName xxx -ServiceName xxx -Name xxx -Description xxx

Deny-AzPrivateEndpointConnection

Identisch mit Approve-AzPrivateEndpointConnection.

Get-AzPrivateEndpointConnection

Identisch mit Approve-AzPrivateEndpointConnection.

Remove-AzPrivateEndpointConnection

Identisch mit Approve-AzPrivateEndpointConnection.

Set-AzPrivateEndpointConnection

Identisch mit Approve-AzPrivateEndpointConnection.

New-AzNetworkWatcherConnectionMonitorEndpointObject

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

Vorher

$MySrcResourceId1 = '/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myresourceGroup/providers/Microsoft.OperationalInsights/workspaces/myworkspace'
$SrcEndpointFilterItem1 =New-AzNetworkWatcherConnectionMonitorEndpointFilterItemObject -Type 'AgentAddress' -Address 'WIN-P0HGNDO2S1B'
$SourceEndpointObject1 = New-AzNetworkWatcherConnectionMonitorEndPointObject -Name 'workspaceEndpoint' -ResourceId $MySrcResourceId1 -FilterType Include -FilterItem $SrcEndpointFilterItem1

Nach

MySrcResourceId1 = '/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myresourceGroup/providers/Microsoft.OperationalInsights/workspaces/myworkspace'
$SourceEndpointObject1 = New-AzNetworkWatcherConnectionMonitorEndPointObject -Name 'workspaceEndpoint' -ResourceId $MySrcResourceId1