Az 7.0.0 の移行ガイド

Az.Accounts

コンテキストとアカウントのコマンドレット

次のコマンドレットの出力が変更されました。

Get-AzContext
Remove-AzContext
Rename-AzContext (名前を変更する - Azコンテキスト)
Select-AzContext
Connect-AzAccount（Azアカウントに接続）
Disconnect-AzAccount
Import-AzContext
Save-AzContext

で ServicePrincipalSecret と CertificatePassword を削除しました PSAzureRmAccount

の前に

PS C:\> $cred = Get-Credential
PS C:\> Connect-AzAccount -ServicePrincipal -Tenant 54826b22-xxxx-xxxx-xxxx-xxxxxxxxxxxxx -Credential $cred
PS C:\> (Get-AzContext).Account.ExtendedProperties

Key                    Value
---                    -----
CertificatePath        C:\certificate.pfx
CertificatePassword    password****
Tenants                54826b22-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
ServicePrincipalSecret 7QK7Q********************************
Subscriptions          0b1f6471-xxxx-xxxx-xxxx-xxxxxxxxxxxxx

後の

PS C:\> $cred = Get-Credential
PS C:\> Connect-AzAccount -ServicePrincipal -Tenant 54826b22-xxxx-xxxx-xxxx-xxxxxxxxxxxxx -Credential $cred
PS C:\> (Get-AzContext).Account.ExtendedProperties

Key             Value
---             -----
CertificatePath C:\certificate.pfx
Tenants         54826b22-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
Subscriptions   0b1f6471-xxxx-xxxx-xxxx-xxxxxxxxxxxxx

Az.Aks

`Get-AzAksVersion`

出力内のプロパティ Upgrades が Upgradeに変更されました。

の前に

PS C:\> (Get-AzAksVersion -location eastus).Upgrades

OrchestratorType OrchestratorVersion IsPreview
---------------- ------------------- ---------
Kubernetes       1.19.13
Kubernetes       1.20.7
Kubernetes       1.20.9
Kubernetes       1.20.7
Kubernetes       1.20.9
Kubernetes       1.20.9
Kubernetes       1.21.1
Kubernetes       1.21.2
Kubernetes       1.21.1
Kubernetes       1.21.2
Kubernetes       1.21.2
Kubernetes       1.22.1              True
Kubernetes       1.22.2              True
Kubernetes       1.22.1              True
Kubernetes       1.22.2              True
Kubernetes       1.22.2              True

後の

PS C:\> (Get-AzAksVersion -location eastus).Upgrade

OrchestratorType OrchestratorVersion IsPreview
---------------- ------------------- ---------
Kubernetes       1.19.13
Kubernetes       1.20.7
Kubernetes       1.20.9
Kubernetes       1.20.7
Kubernetes       1.20.9
Kubernetes       1.20.9
Kubernetes       1.21.1
Kubernetes       1.21.2
Kubernetes       1.21.1
Kubernetes       1.21.2
Kubernetes       1.21.2
Kubernetes       1.22.1              True
Kubernetes       1.22.2              True
Kubernetes       1.22.1              True
Kubernetes       1.22.2              True
Kubernetes       1.22.2              True

Az.ContainerInstance

`New-AzContainerGroup`

パラメーター NetworkProfileId を削除し、その代替として SubnetId を追加しました

の前に

PS C:\>  $containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux -NetworkProfileId "/subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}"
PS C:\> $containerGroup.NetworkProfileId

/subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}

後の

PS C:\> $container = New-AzContainerInstanceObject -Name test-container -Image nginx
PS C:\> $containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType 'Private' -SubnetId @{"Id"="/subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}"; "Name"="subnet"}
PS C:\> $containerGroup.SubnetId | fl

Id :  /subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}
Name : subnet

`Invoke-AzContainerInstanceCommand`

バックエンドで websocket を接続してコマンドレットの出力としてコマンド実行結果を表示しました

の前に

PS C:\> $websocket = Invoke-AzContainerInstanceCommand -ContainerGroupName test-cg -ContainerName test-container -ResourceGroupName　test-rg -Command "echo hello" -TerminalSizeCol 12 -TerminalSizeRow 12
PS C:\> $websocket

Password                                           WebSocketUri
--------                                           ------------
****************** wss://bridge-linux-xx.eastus.management.azurecontainer.io/exec/caas-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/bridge-xxxxxxxxxxxxxxx?rows=12&cols=12api-version=2018-02-01-preview

User needs connect websocket using password to fetch command execution result

後の

PS C:\> Invoke-AzContainerInstanceCommand -ContainerGroupName test-cg -ContainerName test-container -ResourceGroupName　test-rg -Command "echo hello"

hello

Az.Functions

`Update-AzFunctionApp, Update-AzFunctionAppPlan`

Update-AzFunctionApp 確認を求めるメッセージが表示されます。この動作は、 -Forceを指定することでバイパスできます。

の前に

Update-AzFunctionApp -Name MyUniqueFunctionAppName -ResourceGroupName MyResourceGroupName -PlanName NewPlanName

後の

Update-AzFunctionApp -Name MyUniqueFunctionAppName -ResourceGroupName MyResourceGroupName -PlanName NewPlanName -Force

`New-AzFunctionApp`

FunctionsVersion コマンドレットの実行時New-AzFunctionAppパラメーターが指定されていない場合、既定の Functions バージョンは 4 に設定されます。

There is no change to the usage.

`Remove-AzFunctionApp`

これが App Service プランの最後のアプリである場合、プランは削除されません。このリリースの前に、アプリプランも削除されます。

There is no change to the usage.

Az.HDInsight

`New-AzHDInsightCluster`

パラメーター "OSType" の型を Microsoft.Azure.Management.HDInsight.Models.OSType から System.string に変更しました

There is no change to the usage.

`New-AzHDInsightCluster, New-AzHDInsightClusterConfig`

パラメーター "ClusterTier" の型を Microsoft.Azure.Management.HDInsight.Models.ClusterTier から System.string に変更しました

There is no change to the usage.

`Set-AzHDInsightClusterDiskEncryptionKey, Set- AzHDInsightClusterSize`

出力の種類が 'Microsoft.Azure.Management.HDInsight.Models.Cluster' から 'Microsoft.Azure.Commands.HDInsight.Models.AzureHDInsightCluster' に変更されました。

All properties remain the same, so there is no change to the usage.

`Cluster cmdlets`

プロパティ「AssignedIdentity」の型が「Microsoft.Azure.Management.HDInsight.Models.ClusterIdentity」から「Microsoft.Azure.Commands.HDInsight.Models.AzureHDInsightClusterIdentity」に変更されました。

All properties remain the same, so there is no change to the usage.

`Get-AzHDInsightProperties`

出力 'property VmSizes' のジェネリック型が System.Collections.Generic.IDictionary2[System.String,Microsoft.Azure.Commands.HDInsight.Models.Management.AzureHDInsightVmSizesCapability] から System.Collections.Generic.IList1[System.String] に変更されました。

の前に

PS C:\> $result = Get-AzHDInsightProperty -Location "South Central us"
PS C:\> $availableVmSizes = $result.VmSizes['iaas'].AvailableVmSizes

後の

PS C:\> $result = Get-AzHDInsightProperty -Location "South Central us"
PS C:\> $availableVmSizes = $result.VmSizes

Az.KeyVault

`New-AzKeyVaultRoleDefinition, Get-AzKeyVaultRoleDefinition`

PSKeyVaultPermission モデルの次のプロパティの名前が変更されます。

AllowedActions ->Actions
DeniedActions ->NotActions
AllowedDataActions ->DataActions
DeniedDataActions ->NotDataActions

の前に

PS C:\> $backupRole = Get-AzKeyVaultRoleDefinition -HsmName myHsm -RoleDefinitionName "Managed HSM Backup User"

PS C:\> $backupRole.Permissions

AllowedActions DeniedActions AllowedDataActions DeniedDataActions
-------------- ------------- ------------------ -----------------
0 action(s)    0 action(s)   3 action(s)        0 action(s)

PS C:\> $backupRole.Permissions.AllowedDataActions

Microsoft.KeyVault/managedHsm/backup/start/action
Microsoft.KeyVault/managedHsm/backup/status/action
Microsoft.KeyVault/managedHsm/keys/backup/action

後の

PS C:\> $backupRole = Get-AzKeyVaultRoleDefinition -HsmName myHsm -RoleDefinitionName "Managed HSM Backup User"

PS C:\> $backupRole.Permissions

Actions     NotActions  DataActions NotDataActions
-------     ----------  ----------- --------------
0 action(s) 0 action(s) 3 action(s) 0 action(s)

PS C:\> $backupRole.Permissions.DataActions

Microsoft.KeyVault/managedHsm/backup/start/action
Microsoft.KeyVault/managedHsm/backup/status/action
Microsoft.KeyVault/managedHsm/keys/backup/action

Az.ManagedServices

`New-AzManagedServicesDefinition`

-DisplayName パラメーターが削除されました。

の前に

PS C:\> New-AzManagedServicesDefinition -DisplayName "MyTestDefinition" -ManagedByTenantId 00001111-aaaa-2222-bbbb-3333cccc4444 -RoleDefinitionId acdd72a7-3385-48ef-bd42-f606fba81ae7 -PrincipalId aaaaaaaa-bbbb-cccc-1111-222222222222

後の

PS C:\> $permantAuth = New-AzManagedServicesAuthorizationObject -PrincipalId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -RoleDefinitionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -PrincipalIdDisplayName "Test user" -DelegatedRoleDefinitionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
PS C:\> New-AzManagedServicesDefinition -Name xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -RegistrationDefinitionName "Test definition" -ManagedByTenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -Authorization $permantAuth -Description "Test definition desc" -Scope "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Az.Monitor

`Get-AzLog`

プロパティ 'EventName'、'Category'、'ResourceProviderName'、'OperationName'、'Status'、'SubStatus の型が Microsoft.Azure.Management.Monitor.Models.LocalizableString から System.String に変更されました

の前に

PS C:\> $log = Get-AzLog -MaxRecord 1
PS C:\> $eventName = $log.EventName.LocalizedValue
PS C:\> $category = $log.Category.LocalizedValue
PS C:\> $resourceProviderName = $log.ResourceProviderName.LocalizedValue
PS C:\> $operationName = $log.OperationName.LocalizedValue
PS C:\> $status = $log.Status.LocalizedValue
PS C:\> $subStatus = $log.SubStatus.LocalizedValue

後の

PS C:\> $log = Get-AzLog -MaxRecord 1
PS C:\> $eventName = $log.EventName
PS C:\> $category = $log.Category
PS C:\> $resourceProviderName = $log.ResourceProviderName
PS C:\> $operationName = $log.OperationName
PS C:\> $status = $log.Status
PS C:\> $subStatus = $log.SubStatus

`Get-AzMetric,Get-AzMetricDefinition`

プロパティ 'Unit' の型が次のように変更されました System.String

There is no change to the usage.

`New-AzMetricAlertRuleV2Criteria`

プロパティ 'TimeAggregation' の型が次のように変更されました System.String

There is no change to the usage.

Az.OperationalInsights

`Get-AzOperationalInsightsCluster`

"list" を既定のパラメーターセットにしました。

の前に

There is no default parameter set.

後の

Default parameter set is now "list", when providing resource group name - return all clusters for the given resource group.

`Update-AzOperationalInsightsCluster`

"UpdateByNameParameterSet" を既定のパラメーターセットにしました。

の前に

There is no default parameter set.

後の

Default parameter set is now "UpdateByNameParameterSet".

Az.RecoveryServices

`Get-AzRecoveryServicesBackupContainer`

BackupManagementType を MARS から MAB に変更しました。機能は変わりません。これは、コマンドレット間で一貫性を持たせるためです。

の前に

$containers = Get-AzRecoveryServicesBackupContainer -ContainerType Windows -BackupManagementType MARS -VaultId $vault.ID

後の

$cont = Get-AzRecoveryServicesBackupContainer -ContainerType Windows -BackupManagementType MAB -VaultId $vault.ID

`Get-AzRecoveryServicesBackupItem`

BackupManagementType を MARS から MAB に変更しました。機能は変わりません。これは、コマンドレット間で一貫性を持たせるためです

の前に

Get-AzRecoveryServicesBackupItem -BackupManagementType MARS -VaultId $vault.ID -WorkloadType FileFolder

後の

Get-AzRecoveryServicesBackupItem -BackupManagementType MAB -VaultId $vault.ID -WorkloadType FileFolder

`Get-AzRecoveryServicesBackupJob`

BackupManagementType を MARS から MAB に変更しました。機能は変わりません。これは、コマンドレット間で一貫性を持たせるためです

の前に

Get-AzRecoveryServicesBackupJob -BackupManagementType MARS -VaultId $vault.ID

後の

Get-AzRecoveryServicesBackupJob -BackupManagementType MAB -VaultId $vault.ID

Az.Resources

`AzAD cmdlets`

Active Directoryコマンドレットのmigration guideを参照してください。

`PolicyAssignment cmdlets`

型 'Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyAssignment' のプロパティ 'Identity' の型が 'System.Management.Automation.PSObject' から 'Microsoft.Azure.Commands.ResourceManager.Cmdlets.Implementation.Policy.PsPolicyIdentity' に変更されました。

の前に

PS C:\> $v = Get-AzPolicyAssignment -Id $someId
PS C:\> Write-Host $v.type, $v.principalId, $v.tenantId

後の

PS C:\> $v = Get-AzPolicyAssignment -Id $someId
PS C:\> Write-Host $v.IdentityType, $v.PrincipalId, $v.TenantId, $v.UserAssignedIdentities

Az.Storage

`Get-AzRmStorageShare`

リソース ID から名前を推論できるため、パラメーターセット "ShareResourceId" からパラメーター "Name" が削除されました。

の前に

$StorageShare = Get-AzRmStorageShare -ResourceId "/subscriptions/..." -Name "MyStorageShare"

後の

$StorageShare = Get-AzRmStorageShare -ResourceId "/subscriptions/..."

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-05

Az 7.0.0 の移行ガイド

Az.Accounts

コンテキストとアカウントのコマンドレット

の前に

後の

Az.Aks

Get-AzAksVersion

の前に

後の

Az.ContainerInstance

New-AzContainerGroup

の前に

後の

Invoke-AzContainerInstanceCommand

の前に

後の

Az.Functions

Update-AzFunctionApp, Update-AzFunctionAppPlan

の前に

後の

New-AzFunctionApp

Remove-AzFunctionApp

Az.HDInsight

New-AzHDInsightCluster

New-AzHDInsightCluster, New-AzHDInsightClusterConfig

Set-AzHDInsightClusterDiskEncryptionKey, Set- AzHDInsightClusterSize

Cluster cmdlets

Get-AzHDInsightProperties

の前に

後の

Az.KeyVault

New-AzKeyVaultRoleDefinition, Get-AzKeyVaultRoleDefinition

の前に

後の