Průvodce migrací pro Az 5.0.0

Článek
03/05/2025

Tento dokument popisuje změny mezi verzemi 4.0.0 a 5.0.0 az.

Průvodce migrací pro Az 5.0.0
- Az.Aks
  - New-AzAksCluster
  - Set-AzAksCluster
- Az.ContainerRegistry
  - New-AzContainerRegistry
- Az.Functions
  - Get-AzFunctionApp
  - New-AzFunctionApp
- Az.KeyVault
- Az.ManagedServices
- Az.ResourceManager
  - Get-AzManagementGroupDeployment
  - Get-AzManagementGroupDeploymentOperation
  - Get-AzDeployment
  - Get-AzDeploymentOperation
  - Get-AzDeploymentWhatIfResult
  - Get-AzTenantDeployment
  - Get-AzTenantDeploymentOperation
  - New-AzManagementGroupDeployment
  - New-AzDeployment
  - New-AzTenantDeployment
  - Remove-AzManagementGroupDeployment
  - Odebrat AzDeployment
  - Remove-AzTenantDeployment
  - Save-AzManagementGroupDeploymentTemplate
  - Save-AzDeploymentTemplate
  - Save-AzTenantDeploymentTemplate
  - Stop-AzManagementGroupDeployment
  - Stop-AzDeployment
  - Stop-AzTenantDeployment
  - Test-AzManagementGroupDeployment
  - Test-AzDeployment
  - Test-AzTenantDeployment
  - Get-AzResourceGroupDeployment
  - Get-AzResourceGroupDeploymentOperation
  - Get-AzResourceGroupDeploymentWhatIfResult
  - New-AzResourceGroupDeployment
  - Remove-AzResourceGroupDeployment
  - Save-AzResourceGroupDeploymentTemplate
  - Stop-AzResourceGroupDeployment
  - Test-AzResourceGroupDeployment
  - Get-AzManagementGroupDeploymentWhatIfResult
  - Get-AzTenantDeploymentWhatIfResult
- Az.Sql
  - Set-AzSqlServerActiveDirectoryAdministrator
- Az.Synapse
  - New-AzSynapseSqlPool
  - Update-AzSynapseSqlPool
- Az.Network
  - Approve-AzPrivateEndpointConnection
  - Deny-AzPrivateEndpointConnection
  - Get-AzPrivateEndpointConnection
  - Remove-AzPrivateEndpointConnection
  - Set-AzPrivateEndpointConnection
  - New-AzNetworkWatcherConnectionMonitorEndpointObject

Az.Aks

New-AzAksCluster

Už nepodporuje parametr NodeOsType a nebyl nalezen žádný alias pro původní název parametru, bude vždy Linux.
Už nepodporuje alias ClientIdAndSecret pro ServicePrincipalIdAndSecretparametru .
Výchozí hodnota NodeVmSetType se změní z AvailabilitySet na VirtualMachineScaleSets.
Výchozí hodnota NetworkPlugin se změní z none na azure.

Před

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

Po

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

Set-AzAksCluster

Už nepodporuje alias ClientIdAndSecret pro ServicePrincipalIdAndSecretparametru .

Před

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

Po

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

Az.ContainerRegistry

New-AzContainerRegistry

Parametr StorageAccountName už nepodporuje a nebyl nalezen žádný alias pro původní název parametru.

Před

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

Po

Classic byla zastaralá a StorageAccountName byla odebrána, protože funguje jenom se službou Classic Container Registry.

Az.Functions

Get-AzFunctionApp

Odebrali jsme parametr přepínače IncludeSlot ze všech sad parametrů kromě jedné u Get-AzFunctionApp. Rutina cmdlet teď při zadání -IncludeSlot podporuje načítání slotů nasazení ve výsledcích. Tato funkce nefungovala v předchozí verzi cmdletu. Toto je ale opravené.

New-AzFunctionApp

Opravili jsme -DisableApplicationInsights v New-AzFunctionApp, aby se při zadání této možnosti nevytvořil žádný projekt Application Insights.
Odebrali jsme podporu vytváření aplikací funkcí PowerShellu 6.2, protože PowerShell 6.2 je EOL. Místo toho jsou aktuální pokyny pro zákazníky vytvořit funkční aplikace v PowerShellu 7.0.
Změna výchozí verze modulu runtime ve Functions verze 3 ve Windows pro aplikace funkcí PowerShellu z 6.2 na 7.0, pokud není zadaný parametr RuntimeVersion.
Změna výchozí verze modulu runtime ve Functions verze 3 ve Windows a Linuxu pro aplikace funkcí Node z 10 na 12, pokud není zadaný parametr RuntimeVersion. Uživatelé ale můžou aplikace funkcí Node 10 vytvářet zadáním -Runtime Node a -RuntimeVersion 10. Změna výchozí verze modulu runtime ve functions verze 3 v Linuxu pro aplikace funkcí Pythonu z 3.7 na 3.8, pokud není zadaný parametr RuntimeVersion. Uživatelé ale mohou stále vytvářet aplikace funkcí Pythonu 3.7 zadáním -Runtime Python a -RuntimeVersion 3.7.

Před

# 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

Po

# 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

Parametr DisableSoftDelete už nepodporuje a nebyl nalezen žádný alias pro původní název parametru.

Před

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

Po

Schopnost aktualizovat nastavení měkkého odstranění je v Az.KeyVault 3.0.0 zastaralá. Číst více

Update-AzKeyVault

Už nepodporuje parametr EnableSoftDelete, SoftDeleteRetentionInDaysa nebyl nalezen žádný alias pro původní název parametru.

Před

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

Po

Možnost aktualizovat nastavení měkkého odstranění je v Az.KeyVault 3.0.0 zastaralá. Číst více

Get-AzKeyVaultSecret

Vlastnost SecretValueText typu Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret byla odebrána. Buď použijte -AsPlainText na volání, abyste získali tajný kód ve formátu prostého textu, nebo použijte $secret.SecretValue typu SecureString ve skriptu.

Před

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

Po

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Parametr ResourceId už nepodporuje a nebyl nalezen žádný alias pro původní název parametru.

Před

Get-AzManagedServicesDefinition -ResourceId xxx

Po

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Už nepodporuje parametr RegistrationDefinitionName, RegistrationDefinitionResourceIda nebyl nalezen žádný alias pro původní název parametru.

Před

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Po

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Už nepodporuje parametr Id, ResourceIda nebyl nalezen žádný alias pro původní název parametru.

Před

Remove-AzManagedServicesAssignment -ResourceId xxx

Po

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Už nepodporuje parametr Id, ResourceIda nebyl nalezen žádný alias pro původní název parametru.

Před

Remove-AzManagedServicesDefinition -ResourceId xxx

Po

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Parametr ApiVersion už nepodporuje a nebyl nalezen žádný alias pro původní název parametru.

Před

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