Przewodnik migracji dla modułu Az 5.0.0

Artykuł
10/08/2024

Ten dokument zawiera opis różnic między wersjami 4.0.0 i 5.0.0 modułu Az.

Przewodnik migracji dla modułu Az 5.0.0

Az.Aks

New-AzAksCluster

Nie obsługuje już parametru NodeOsType, a alias nazwy oryginalnego parametru nie został znaleziony, zawsze będzie to Linux.
Nie obsługuje już aliasu ClientIdAndSecret dla parametru ServicePrincipalIdAndSecret.
Wartość domyślna parametru NodeVmSetType została zmieniona z AvailabilitySet na VirtualMachineScaleSets.
Wartość domyślna parametru NetworkPlugin została zmieniona 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, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

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

Po

Element Classic został uznany za przestarzały i parametr StorageAccountName został usunięty, ponieważ działa tylko z klasycznym rejestrem kontenerów.

Az.Functions

Get-AzFunctionApp

Usunięto parametr przełącznika IncludeSlot ze wszystkich zestawów parametrów oprócz jednego: Get-AzFunctionApp. Polecenie cmdlet obsługuje teraz pobieranie miejsc wdrożenia w wynikach, gdy określono -IncludeSlot. Ta funkcja była uszkodzona w poprzedniej wersji polecenia cmdlet. Jednak teraz jest to naprawione.

New-AzFunctionApp

Naprawiono opcję -DisableApplicationInsights w poleceniu New-AzFunctionApp, dzięki czemu nie jest tworzony projekt usługi Application Insights, gdy określono tę opcję.
Usunięto obsługę tworzenia aplikacji funkcji programu PowerShell 6.2, ponieważ okres obsługi programu PowerShell 6.2 został zakończony. Bieżącą wytyczną dla klientów jest utworzenie zamiast tego 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 programu Node z 10 na 12, gdy nie określono parametru RuntimeVersion. Jednak użytkownicy nadal mogą tworzyć aplikacje funkcji Node 10, określając elementy -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 3.7 na 3.8, gdy nie określono parametru RuntimeVersion. Jednak użytkownicy mogą nadal tworzyć aplikacje funkcji języka Python 3.7, określając elementy -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, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

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

Po

Możliwość aktualizowania ustawienia usuwania nietrwałego jest przestarzała w module Az.KeyVault 3.0.0. Dowiedz się więcej

Update-AzKeyVault

Nie obsługuje już parametru EnableSoftDelete, SoftDeleteRetentionInDays, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

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

Po

Możliwość aktualizowania ustawienia usuwania nietrwałego jest przestarzała w module Az.KeyVault 3.0.0. Dowiedz się więcej

Get-AzKeyVaultSecret

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

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, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

Get-AzManagedServicesDefinition -ResourceId xxx

Po

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Nie obsługuje już parametru RegistrationDefinitionName, RegistrationDefinitionResourceId, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Po

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Nie obsługuje już parametru Id, ResourceId, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

Remove-AzManagedServicesAssignment -ResourceId xxx

Po

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Nie obsługuje już parametru Id, ResourceId, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

Remove-AzManagedServicesDefinition -ResourceId xxx

Po

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Nie obsługuje już parametru ApiVersion, a alias nazwy oryginalnego parametru nie został znaleziony.

Przed

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