Az 6.0.0 の移行ガイド

[アーティクル]
04/04/2024

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

Az 6.0.0 の移行ガイド

PowerShell のサポートされているバージョン

CVE-2021-26701 が原因で、Az 6 は次のプラットフォームでのみサポートされています。

PowerShell 7.1: バージョン 7.1.3 以上
PowerShell 7.0: バージョン 7.0.6 以上
Windows PowerShell 5.1

詳細については、「Azure PowerShell のサポートライフサイクル」を参照してください

Az.Accounts

`Connect-AzAccount`

古いパラメーター ManagedServiceHostName、ManagedServicePort、ManagedServiceSecret を削除しました。

以前

Connect-AzAccount -Identity -ManagedServiceSecret $secret

これらの手順の完了後、

#To use customized MSI endpoint, please set environment variable MSI_ENDPOINT, e.g. "http://localhost:50342/oauth2/token"; to use customized MSI secret, please set environment variable MSI_SECRET.
Connect-AzAccount -Identity

Az.ContainerInstance

`New-AzContainerGroup`

パラメーター Image、RegistryCredential、AzureFileVolumeShareName、AzureFileVolumeAccountCredential、AzureFileVolumeMountPath、IdentityId、AssignIdentity、OsType、Cpu、MemoryInGB、IpAddressType、DnsNameLabel、Port、Command、EnvironmentVariable、RegistryServerDomain がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

以前

PS C:\> New-AzContainerGroup -ResourceGroupName demo -Name mycontainer -Image nginx -OsType Linux -IpAddressType Public -Port @(8000)

ResourceGroupName        : demo
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {8000}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

これらの手順の完了後、

PS C:\> $port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
PS C:\> $port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP
PS C:\> $container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5 -Port @($port1, $port2)
PS C:\> $containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

Location Name    Type
-------- ----    ----
eastus   test-cg Microsoft.ContainerInstance/containerGroups

`Remove-AzContainerGroup`

コマンドレット 'Remove-AzContainerGroup' でパラメーター 'ResourceId' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

以前

PS C:\> Find-AzResource -ResourceGroupEquals MyResourceGroup -ResourceNameEquals MyContainer | Remove-AzContainerGroup

これらの手順の完了後、

PS C:\> Remove-AzContainerGroup -Name test-cg -ResourceGroupName test-rg

Location Name    Type
-------- ----    ----
eastus   test-cg Microsoft.ContainerInstance/containerGroups

`Get-AzContainerGroup`

コマンドレット 'Get-AzContainerGroup' でパラメーター 'ResourceId' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

以前

PS C:\> Find-AzResource -ResourceGroupEquals demo -ResourceNameEquals mycontainer | Get-AzContainerGroup

ResourceGroupName        : demo
Id                       : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Succeeded
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {8000}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

これらの手順の完了後、

PS C:\> Get-AzContainerGroup

Location Name           Type
-------- ----           ----
eastus   bez-cg1         Microsoft.ContainerInstance/containerGroups
eastus   bez-cg2        Microsoft.ContainerInstance/containerGroups

`Get-AzContainerInstanceLog`

コマンドレット 'Get-AzContainerInstanceLog' でパラメーター 'ResourceId' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。コマンドレット 'Get-AzContainerInstanceLog' でパラメーター 'Name' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

以前

PS C:\> Get-AzContainerGroup -ResourceGroupName demo -Name mycontainer | Get-AzContainerInstanceLog

Log line 1.
Log line 2.
Log line 3.
Log line 4.

これらの手順の完了後、

PS C:\> Get-AzContainerInstanceLog -ContainerGroupName test-cg -ContainerName test-container -ResourceGroupName test-rg

Az.DesktopVirtualization

`New-AzWvdHostPool`

コマンドレット 'New-AzWvdHostPool' でパラメーター 'SsoContext' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

`Expand-AzWvdMsixImage`

コマンドレット 'Expand-AzWvdMsixImage' で、パラメーター 'MsixImageUri' の型 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri' はサポートされなくなりました。

以前

$MsixImageUri = [Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixImageUri]::New()
Get-AzWvdDesktop -ResourceGroupName ResourceGroupName -ApplicationGroupName ApplicationGroupName -Name DesktopName | Expand-AzWvdMsixImage -MsixImageUri $MsixImageUri

これらの手順の完了後、

$MsixImageUri = [Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixImageUri]::New()
Get-AzWvdDesktop -ResourceGroupName ResourceGroupName -ApplicationGroupName ApplicationGroupName -Name DesktopName | Expand-AzWvdMsixImage -MsixImageUri $MsixImageUri

`New-AzWvdMsixPackage`

パラメーター 'PackageApplication' の要素の型が、'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications' から 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications' に変更されました。パラメーター 'PackageDependency' の要素の型が、'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies' から 'Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies' に変更されました。

以前

PS C:\> $apps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageApplications]::New())
PS C:\> $deps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20201102Preview.IMsixPackageDependencies]::New())
PS C:\> New-AzWvdMsixPackage -FullName PackageFullName `
							-HostPoolName HostPoolName `
							-ResourceGroupName ResourceGroupName `
							-SubscriptionId SubscriptionId `
							-DisplayName displayname `
							-ImagePath imageURI `
							-IsActive:$false `
							-IsRegularRegistration:$false `
							-LastUpdated datelastupdated `
							-PackageApplication $apps `
							-PackageDependency $deps `
							-PackageFamilyName packagefamilyname `
							-PackageName packagename `
							-PackageRelativePath packagerelativepath `
							-Version packageversion `

これらの手順の完了後、

PS C:\> $apps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageApplications]::New())
PS C:\> $deps = @([Microsoft.Azure.PowerShell.Cmdlets.DesktopVirtualization.Models.Api20210201Preview.IMsixPackageDependencies]::New())
PS C:\> New-AzWvdMsixPackage -FullName PackageFullName `
							-HostPoolName HostPoolName `
							-ResourceGroupName ResourceGroupName `
							-SubscriptionId SubscriptionId `
							-DisplayName displayname `
							-ImagePath imageURI `
							-IsActive:$false `
							-IsRegularRegistration:$false `
							-LastUpdated datelastupdated `
							-PackageApplication $apps `
							-PackageDependency $deps `
							-PackageFamilyName packagefamilyname `
							-PackageName packagename `
							-PackageRelativePath packagerelativepath `
							-Version packageversion `

`Update-AzWvdHostPool`

コマンドレット 'Update-AzWvdHostPool' でパラメーター 'SsoContext' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

Az.StreamAnalytics

`Get-AzStreamAnalyticsDefaultFunctionDefinition`

コマンドレット 'Get-AzStreamAnalyticsDefaultFunctionDefinition' でパラメーター 'File' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

以前

Get-AzStreamAnalyticsDefaultFunctionDefinition -ResourceGroupName "StreamAnalytics-Default-West-US" -JobName "StreamJob22" -File "C:\RetrieveDefaultDefinitionRequest.json" -Name "ScoreTweet"

これらの手順の完了後、

Get-AzStreamAnalyticsDefaultFunctionDefinition -ResourceGroupName azure-rg-test -JobName sajob-01-pwsh -Name mlsfunction-01 -BindingType Microsoft.MachineLearningServices -Endpoint "http://875da830-4d5f-44f1-b221-718a5f26a21d.eastus.azurecontainer.io/score"-UdfType Scalar
Input is specified in flattened parameters instead from the input file.

`New-AzStreamAnalyticsJob`

コマンドレット 'New-AzStreamAnalyticsJob' でパラメーター 'File' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

以前

New-AzStreamAnalyticsJob -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\JobDefinition.json"

これらの手順の完了後、

New-AzStreamAnalyticsJob -ResourceGroupName azure-rg-test -Name sajob-02-pwsh -Location westcentralus -SkuName Standard
Input is specified in flattened parameters instead from the input file.

`New-AzStreamAnalyticsTransformation`

コマンドレット 'New-AzStreamAnalyticsTransformation' でパラメーター 'File' がサポートされなくなりました。元のパラメーター名の別名は見つかりませんでした。

以前

New-AzStreamAnalyticsTransformation -ResourceGroupName "StreamAnalytics-Default-West-US" -File "C:\Transformation.json" -JobName "StreamingJob" -Name "StreamingJobTransform"

これらの手順の完了後、

New-AzStreamAnalyticsTransformation -ResourceGroupName azure-rg-test -JobName sajob-01-pwsh -Name tranf-01 -StreamingUnit 6 -Query "Select Id, Name from input-01"
Input is specified in flattened parameters instead from the input file.

Az.RecoveryServices

`Set-AzRecoveryServicesBackupProperty`

Set-AzRecoveryServicesBackupProperties 複数形別名を削除しました。今後は Set-AzRecoveryServicesBackupProperty コマンドレット名を使用してください

`Get-AzRecoveryServicesBackupJobDetail`

Get-AzRecoveryServicesBackupJobDetails 複数形別名を削除しました。今後は Get-AzRecoveryServicesBackupJobDetail コマンドレット名を使用してください

以前

$jobDetails = Get-AzRecoveryServicesBackupJobDetails -VaultId $vault.ID -Job $job
$jobDetails2 = Get-AzRecoveryServicesBackupJobDetails -VaultId $vault.ID -JobId $job.JobId

これらの手順の完了後、

$jobDetails = Get-AzRecoveryServicesBackupJobDetail -VaultId $vault.ID -Job $job
$jobDetails2 = Get-AzRecoveryServicesBackupJobDetail -VaultId $vault.ID -JobId $job.JobId

Az.Storage

`Remove-AzRmStorageShare`

コマンドレット 'Remove-AzRmStorageShare' により、以前は既定でスナップショットを含む共有を削除できましたが、変更後は、スナップショットを含む共有の削除は既定で失敗します。正常に削除するには、パラメーター "-Include Snapshots" を追加する必要があります。

以前

Remove-AzRmStorageShare -ResourceGroupName $resourceGroupName -StorageAccountName $accountName -Name $shareName

これらの手順の完了後、

Remove-AzRmStorageShare -ResourceGroupName $resourceGroupName -StorageAccountName $accountName -Name $shareName -Force -Include Snapshots

Az.ServiceFabric

`Add-AzServiceFabricClusterCertificate`

このコマンドレットは完全に削除されました。クラスター証明書を追加するには、こちらの手順に従ってください。

`Get-AzServiceFabricManagedClusterService`

sdk から直接 properties パラメーターを使用しないように PSManagedService モデルを変更します。現在はすべてのプロパティが、オブジェクトの最初のレベル内にあります。また、非推奨のパラメーター InstanceCloseDelayDuration、DropSourceReplicaOnMove、ServiceDnsName を削除します

以前

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.Properties.ProvisioningState

これらの手順の完了後、

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.ProvisioningState

`New-AzServiceFabricManagedCluster`

非推奨のパラメーター ReverseProxyEndpointPort を削除します。

`New-AzServiceFabricManagedClusterService`

以前

$service = New-AzServiceFabricManagedClusterService -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationName $appName -Name $serviceName -Type $serviceTypeName -Stateless -InstanceCount -1 -PartitionSchemaSingleton
$statelessService.Properties.ProvisioningState

これらの手順の完了後、

$service = New-AzServiceFabricManagedClusterService -ResourceGroupName $resourceGroupName -ClusterName $clusterName -ApplicationName $appName -Name $serviceName -Type $serviceTypeName -Stateless -InstanceCount -1 -PartitionSchemaSingleton
$statelessService.ProvisioningState

`Remove-AzServiceFabricClusterCertificate`

このコマンドレットは完全に削除されました。クラスター証明書を追加するには、こちらの手順に従ってください。

`Remove-AzServiceFabricManagedClusterService`

sdk から直接 properties パラメーターを使用しないように PSManagedService モデルを変更します。現在はすべてのプロパティが、オブジェクトの最初のレベル内にあります。

`Set-AzServiceFabricManagedCluster`

非推奨のパラメーター ReverseProxyEndpointPort を削除します。

`Set-AzServiceFabricManagedClusterService`

以前

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.Properties.MinInstanceCount = 3
service | Set-AzServiceFabricManagedClusterService

After

$service = Get-AzServiceFabricManagedClusterService -ResourceId $resourceId
$statelessService.MinInstanceCount = 3
service | Set-AzServiceFabricManagedClusterService

Az 6.0.0 の移行ガイド

PowerShell のサポートされているバージョン

Az.Accounts

Connect-AzAccount

以前

これらの手順の完了後、

Az.ContainerInstance

New-AzContainerGroup

以前

これらの手順の完了後、

Remove-AzContainerGroup

以前

これらの手順の完了後、

Get-AzContainerGroup

以前

これらの手順の完了後、

Get-AzContainerInstanceLog

以前

これらの手順の完了後、

Az.DesktopVirtualization

New-AzWvdHostPool

Expand-AzWvdMsixImage

以前

これらの手順の完了後、

New-AzWvdMsixPackage

以前

これらの手順の完了後、

Update-AzWvdHostPool

Az.StreamAnalytics

Get-AzStreamAnalyticsDefaultFunctionDefinition

以前

これらの手順の完了後、

New-AzStreamAnalyticsJob

以前

これらの手順の完了後、

New-AzStreamAnalyticsTransformation

以前

これらの手順の完了後、

Az.RecoveryServices

Set-AzRecoveryServicesBackupProperty

Get-AzRecoveryServicesBackupJobDetail

以前

これらの手順の完了後、

Az.Storage

Remove-AzRmStorageShare

以前

これらの手順の完了後、

Az.ServiceFabric

Add-AzServiceFabricClusterCertificate

Get-AzServiceFabricManagedClusterService

以前

これらの手順の完了後、

New-AzServiceFabricManagedCluster

New-AzServiceFabricManagedClusterService

以前

これらの手順の完了後、

Remove-AzServiceFabricClusterCertificate

Remove-AzServiceFabricManagedClusterService

Set-AzServiceFabricManagedCluster

Set-AzServiceFabricManagedClusterService

以前

After

フィードバック

その他のリソース

`Connect-AzAccount`

`New-AzContainerGroup`

`Remove-AzContainerGroup`

`Get-AzContainerGroup`

`Get-AzContainerInstanceLog`

`New-AzWvdHostPool`

`Expand-AzWvdMsixImage`

`New-AzWvdMsixPackage`

`Update-AzWvdHostPool`

`Get-AzStreamAnalyticsDefaultFunctionDefinition`

`New-AzStreamAnalyticsJob`

`New-AzStreamAnalyticsTransformation`

`Set-AzRecoveryServicesBackupProperty`

`Get-AzRecoveryServicesBackupJobDetail`

`Remove-AzRmStorageShare`

`Add-AzServiceFabricClusterCertificate`

`Get-AzServiceFabricManagedClusterService`

`New-AzServiceFabricManagedCluster`

`New-AzServiceFabricManagedClusterService`

`Remove-AzServiceFabricClusterCertificate`

`Remove-AzServiceFabricManagedClusterService`

`Set-AzServiceFabricManagedCluster`

`Set-AzServiceFabricManagedClusterService`