Przewodnik migracji dla modułu Az 5.0.0

Artykuł
03/05/2025

W tym dokumencie opisano zmiany między wersjami Az 4.0.0 i 5.0.0.

Przewodnik migracji dla modułu 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
  - Remove-AzDeployment
  - Remove-AzTenantDeployment
  - save-AzManagementGroupDeploymentTemplate
  - Save-AzDeploymentTemplate
  - Save-AzTenantDeploymentTemplate
  - Stop-AzManagementGroupDeployment:Zatrzymaj wdrożenie grupy zarządzania w Azure
  - 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
  - Aktualizuj-AzSynapseSqlPool
- Az.Network

Az.Aks

New-AzAksCluster

Nie obsługuje już parametru NodeOsType i nie znaleziono aliasu dla oryginalnej nazwy parametru, zawsze będzie Linux.
Nie obsługuje już aliasu ClientIdAndSecret dla parametru ServicePrincipalIdAndSecret.
Wartość domyślna NodeVmSetType jest zmieniana z AvailabilitySet na VirtualMachineScaleSets.
Wartość domyślna NetworkPlugin jest zmieniana z none na azure.

Przed

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

Nie obsługuje już aliasu ClientIdAndSecret dla parametru ServicePrincipalIdAndSecret.

Przed

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

Nie obsługuje już parametru StorageAccountName i nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

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

Po

Classic została wycofana i StorageAccountName została usunięta, ponieważ działa tylko z klasycznym rejestrem kontenerów.

Az.Functions

Get-AzFunctionApp

Usunięto parametr przełącznika IncludeSlot ze wszystkich poza jednym zestawem parametrów Get-AzFunctionApp. Polecenie cmdlet obsługuje teraz pobieranie slotów wdrożeniowych w wynikach, gdy określono -IncludeSlot. Ta funkcja została przerwana w poprzedniej wersji polecenia cmdlet. Jest to jednak teraz naprawione.

New-AzFunctionApp

Naprawiono -DisableApplicationInsights w New-AzFunctionApp tak, że po określeniu tej opcji nie jest tworzony żaden projekt usługi Application Insights.
Usunięto obsługę tworzenia aplikacji funkcyjnych PowerShell 6.2, ponieważ PowerShell 6.2 osiągnął koniec okresu wsparcia (EOL). Bieżące wskazówki dla klientów polegają na tworzeniu aplikacji funkcji programu PowerShell 7.0.
Zmieniono domyślną wersję środowiska uruchomieniowego w usłudze Functions w wersji 3 w systemie Windows dla aplikacji funkcji programu PowerShell z 6.2 na 7.0, gdy nie określono parametru RuntimeVersion.
Zmieniono domyślną wersję środowiska uruchomieniowego w usłudze Functions w wersji 3 w systemach Windows i Linux dla aplikacji funkcji Node.js z 10 na 12, gdy nie określono parametru RuntimeVersion. Jednak użytkownicy nadal mogą tworzyć aplikacje funkcji node 10, określając -Runtime Node i -RuntimeVersion 10. Zmieniono domyślną wersję środowiska uruchomieniowego w usłudze Functions w wersji 3 w systemie Linux dla aplikacji funkcji języka Python z wersji 3.7 na 3.8, gdy nie określono parametru RuntimeVersion. Jednak użytkownicy nadal mogą tworzyć aplikacje funkcji języka Python 3.7, określając -Runtime Python i -RuntimeVersion 3.7.

Przed

# 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

Nie obsługuje już parametru DisableSoftDelete i nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

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

Po

Możliwość zmiany ustawienia dotyczącego funkcji soft-delete jest przestarzała w wersji 3.0.0 programu Az.KeyVault. Przeczytaj więcej

Update-AzKeyVault

Nie obsługuje już parametru EnableSoftDelete, SoftDeleteRetentionInDaysi nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

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

Po

Możliwość aktualizowania ustawienia miękkiego usuwania jest przestarzała w wersji Az.KeyVault 3.0.0. Przeczytaj więcej

Get-AzKeyVaultSecret

Właściwość SecretValueText typu Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret została usunięta. Zastosuj -AsPlainText do wywołania w celu uzyskania wpisu tajnego w postaci zwykłego tekstu lub użyj $secret.SecretValue typu SecureString w skrypcie.

Przed

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

Po

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Nie obsługuje już parametru ResourceId i nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

Get-AzManagedServicesDefinition -ResourceId xxx

Po

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Nie obsługuje już parametru RegistrationDefinitionName, RegistrationDefinitionResourceIdi nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Po

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Nie obsługuje już parametru Id, ResourceIdi nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

Remove-AzManagedServicesAssignment -ResourceId xxx

Po

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Nie obsługuje już parametru Id, ResourceIdi nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

Remove-AzManagedServicesDefinition -ResourceId xxx

Po

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Nie obsługuje już parametru ApiVersion i nie znaleziono aliasu dla oryginalnej nazwy parametru.

Przed

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