Az 5.0.0 の移行ガイド

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

Az 5.0.0 の移行ガイド

Az.Aks

New-AzAksCluster

パラメーター NodeOsType がサポートされなくなり、元のパラメーター名のエイリアスが見つかりませんでした。常に Linuxされます。
パラメーター ClientIdAndSecretのエイリアス ServicePrincipalIdAndSecretはサポートされなくなりました。
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

パラメーター ClientIdAndSecretのエイリアス ServicePrincipalIdAndSecretはサポートされなくなりました。

以前は

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 はクラシックコンテナーレジストリでのみ動作するため削除されました。

Az.Functions

Get-AzFunctionApp

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

New-AzFunctionApp

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

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

以前は

$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