Az 5.0.0 の移行ガイド

[アーティクル]
11/07/2024

このドキュメントでは、Az のバージョン 4.0.0 と 5.0.0 の間での変更点について説明します。

Az 5.0.0 の移行ガイド

Az.Aks

New-AzAksCluster

パラメーター NodeOsType がサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。これは常に Linux になります。
パラメーター ServicePrincipalIdAndSecret の別名 ClientIdAndSecret はサポートされなくなりました。
NodeVmSetType の既定値は AvailabilitySet から VirtualMachineScaleSets に変更されました。
NetworkPlugin の既定値は none から azure に変更されました。

以前

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

これらの手順の完了後、

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

Set-AzAksCluster

パラメーター ServicePrincipalIdAndSecret の別名 ClientIdAndSecret はサポートされなくなりました。

以前

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

これらの手順の完了後、

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

Az.ContainerRegistry

New-AzContainerRegistry

パラメーター StorageAccountName はサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

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

これらの手順の完了後、

Classic は非推奨となり、StorageAccountName は従来の Container Registry でのみ動作するため削除されました。

Az.Functions

Get-AzFunctionApp

Get-AzFunctionApp の 1 つのパラメーターセット以外のすべてから IncludeSlot スイッチパラメーターが削除されました。このコマンドレットでは、-IncludeSlot が指定された場合、結果内のデプロイスロットの取得がサポートされるようになりました。この機能は以前のコマンドレットのバージョンでは破損していました。しかし、これは修正されました。

New-AzFunctionApp

New-AzFunctionApp の -DisableApplicationInsights が修正され、このオプションが指定されたときに Application Insights プロジェクトが作成されなくなりました。
PowerShell 6.2 が廃止されたため、PowerShell 6.2 の関数アプリの作成がサポートされなくなりました。お客様向けの現在のガイダンスは、代わりに PowerShell 7.0 関数アプリを作成することです。
RuntimeVersion パラメーターが指定されていない場合、PowerShell 関数アプリ用の、Windows での Functions バージョン 3 の既定のランタイムバージョンが 6.2 から 7.0 に変更されました。
RuntimeVersion パラメーターが指定されていない場合、Node 関数アプリ用の、Windows および Linux での Functions バージョン 3 の既定のランタイムバージョンが 10 から 12 に変更されました。ただし、ユーザーは -Runtime Node と -RuntimeVersion 10 を指定すると、Node 10 の関数アプリを引き続き作成できます。 RuntimeVersion パラメーターが指定されていない場合、Python 関数アプリ用の、Linux での Functions バージョン 3 の既定のランタイムバージョンが 3.7 から 3.8 に変更されました。ただし、ユーザーは -Runtime Python と -RuntimeVersion 3.7を指定すると、Python 3.7 の関数アプリを引き続き作成できます。

以前

# 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

これらの手順の完了後、

# 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

パラメーター DisableSoftDelete はサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

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

これらの手順の完了後、

論理削除設定を更新する機能は、Az.KeyVault 3.0.0 では非推奨となります。詳細については、こちらを参照してください。

Update-AzKeyVault

パラメーター EnableSoftDelete、SoftDeleteRetentionInDays がサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

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

これらの手順の完了後、

論理削除設定を更新する機能は、Az.KeyVault 3.0.0 では非推奨となります。詳細については、こちらを参照してください。

Get-AzKeyVaultSecret

Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret 型の SecretValueText プロパティが削除されました。プレーンテキストシークレットを取得するために呼び出しに -AsPlainText を適用するか、スクリプトで SecureString 型の $secret.SecretValue を使用します。

以前

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

これらの手順の完了後、

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

Az.ManagedServices

Get-AzManagedServicesDefinition

パラメーター ResourceId はサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

Get-AzManagedServicesDefinition -ResourceId xxx

これらの手順の完了後、

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

パラメーター RegistrationDefinitionName、RegistrationDefinitionResourceId がサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

これらの手順の完了後、

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

パラメーター Id、ResourceId がサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

Remove-AzManagedServicesAssignment -ResourceId xxx

これらの手順の完了後、

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

パラメーター Id、ResourceId がサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

Remove-AzManagedServicesDefinition -ResourceId xxx

これらの手順の完了後、

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

パラメーター ApiVersion はサポートされなくなり、元のパラメーター名の別名は見つかりませんでした。

以前

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