Az 7.0.0 の移行ガイド

Az.Accounts

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

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

Get-AzContext
Remove-AzContext
Rename-AzContext
Select-AzContext
Connect-AzAccount
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 コマンドレットの移行ガイドを参照してください。

`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-05-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

以前は

クリック後

Az.ManagedServices

New-AzManagedServicesDefinition

以前は

クリック後

Az.Monitor

Get-AzLog

以前は

クリック後

Get-AzMetric,Get-AzMetricDefinition

New-AzMetricAlertRuleV2Criteria

Az.OperationalInsights

Get-AzOperationalInsightsCluster

以前は

クリック後

Update-AzOperationalInsightsCluster

以前は

クリック後

Az.RecoveryServices

Get-AzRecoveryServicesBackupContainer

以前は

クリック後

Get-AzRecoveryServicesBackupItem

以前は

クリック後

Get-AzRecoveryServicesBackupJob

以前は

クリック後

Az.Resources

AzAD cmdlets

PolicyAssignment cmdlets

以前は

クリック後

Az.Storage

Get-AzRmStorageShare

以前は

クリック後

その他のリソース

`Get-AzAksVersion`

`New-AzContainerGroup`

`Invoke-AzContainerInstanceCommand`

`Update-AzFunctionApp, Update-AzFunctionAppPlan`

`New-AzFunctionApp`

`Remove-AzFunctionApp`

`New-AzHDInsightCluster`

`New-AzHDInsightCluster, New-AzHDInsightClusterConfig`

`Set-AzHDInsightClusterDiskEncryptionKey, Set- AzHDInsightClusterSize`

`Cluster cmdlets`

`Get-AzHDInsightProperties`

`New-AzKeyVaultRoleDefinition, Get-AzKeyVaultRoleDefinition`

`New-AzManagedServicesDefinition`

`Get-AzLog`

`Get-AzMetric,Get-AzMetricDefinition`

`New-AzMetricAlertRuleV2Criteria`

`Get-AzOperationalInsightsCluster`

`Update-AzOperationalInsightsCluster`

`Get-AzRecoveryServicesBackupContainer`

`Get-AzRecoveryServicesBackupItem`

`Get-AzRecoveryServicesBackupJob`

`AzAD cmdlets`

`PolicyAssignment cmdlets`

`Get-AzRmStorageShare`