Azure PowerShell – Az モジュール v7.0.0 がリリースされました

2021/12/07 (現地時間) に Azure PowerShell – Az モジュール の最新版である v7.0.0 がリリースされました。
※約半年ぶりのメジャー バージョンアップとなります。

• Release Az 7.0.0 · Azure/azure-powershell
  https://github.com/Azure/azure-powershell/releases/tag/v7.0.0-December2021

Azure PowerShell – Az モジュール v7.0.0 について、MSI インストーラー (x64)、(x86)、および PowerShell Gallery 経由で入手、適用可能となっています。

Azure PowerShell – Az モジュール v7.0.0 をインストールおよびインポート後、バージョンが v7.0.0 となっていることが確認できます。

Az モジュール v7.0.0 について (意訳)

• Azure PowerShell – Az モジュール v7.0.0 インストーラー (x64) : リンク
• Azure PowerShell – Az モジュール v7.0.0 インストーラー (x86) : リンク
• Gallery Module for Azure PowerShell : リンク

PowerShell Gallery から Az をインストールする場合、次のコマンドを実行します :

 Install-Module -Name Az -Repository PSGallery -Force 

古い Az のバージョンからアップデートする場合、次のコマンドを実行します :

 Update-Module -Name Az 

Docker イメージ

• mcr.microsoft.com/azure-powershell:latest
• mcr.microsoft.com/azure-powershell:ubuntu-18.04
• mcr.microsoft.com/azure-powershell:7.0.0-ubuntu-18.04
• mcr.microsoft.com/azure-powershell:debian-9
• mcr.microsoft.com/azure-powershell:7.0.0-debian-9
• mcr.microsoft.com/azure-powershell:centos-7
• mcr.microsoft.com/azure-powershell:7.0.0-centos-7
• mcr.microsoft.com/azure-powershell:alpine-3.10
• mcr.microsoft.com/azure-powershell:7.0.0-alpine-3.10

リリース ノート (7.0.0 – December 2021)

Az.Accounts

• ‘PSAzureRmAccount’ で ‘ServicePrincipalSecret’ と ‘CertificatePassword’ が削除 [#15427]
• ‘Connect-AzAccount’ にオプション パラメーター ‘MicrosoftGraphAccessToken’ を追加
• ‘Add-AzEnvironment’ および ‘Set-AzEnvironment’ にオプション パラメーター ‘MicrosoftGraphEndpointResourceId’、’MicrosoftGraphUrl’ を追加
• ‘Connect-AzAccount’ の ‘UserWithSubscriptionId’ パラメーター セットに ‘-AccountId’ プロパティを追加。インタラクティブ ログイン用にユーザー名を事前に選択可能
• ‘Invoke-AzRestMethod’ に ‘-Uri’ と ‘-ResourceId’ を追加
• 次のコマンドレットに Environment auto completer を追加 [#15991]
  • Connect-AzAccount
  • Get-AzEnvironment
  • Set-AzEnvironment
  • Remove-AzEnvironment
• User-Agent 文字列にモジュール名とバージョンを追加 [#16291]

Az.Advisor

• ‘Az.Advisor.psd1’ が署名されなかった問題を修正 [#16226]

Az.Aks

• [重大な変更] ‘Get-AzAksVersion’ のパラメーター エイリアスおよび出力タイプをアップデート
• aks クラスターでのシェル コマンド (kubectl、helm を使用) の実行をサポートするため、 ‘Invoke-AzAksRunCommand’ を追加 [#16104]
• ‘New-AzAksCluster’ および ‘New-AzAksNodePool’ の ‘EnableNodePublicIp’ と ‘NodePublicIPPrefixID’ サポートを追加 [#15656]
• ‘New-AzAksCluster’ でサービス プリンシパルを作成するロジックを ‘Azure Active Directory Graph’ から ‘Microsoft Graph’ に移行
• ノード プールのバージョンがクラスターのバージョンと一致しない場合、’Set-AzAksCluster’ がクラスターをアップグレードできない問題を修正 [#14583]
• ‘PSKubernetesCluster’ に ‘ResourceGroupName’ を追加 [#15802]

Az.ApplicationInsights

• WebTest 関数を追加。新しいコマンドレットは、以下のとおり :
  • ‘Get-AzApplicationInsightsWebTest’
  • ‘New-AzApplicationInsightsWebTest’
  • ‘New-AzApplicationInsightsWebTestGeolocationObject’
  • ‘New-AzApplicationInsightsWebTestHeaderFieldObject’
  • ‘Remove-AzApplicationInsightsWebTest’
  • ‘Update-AzApplicationInsightsWebTestTag’

Az.Automation

• ‘Remove-AzAutomationHybridWorkerGroup’ のリファレンス ドキュメントの例を修正

Az.CloudService

• ‘Az.CloudService’ モジュールが一般提供 (GA)

Az.Compute

• 次の PowerShell コマンドレットのアップデートが含まれる :
  • ‘SetAzVmssDiskEncryptionExtension’
    • テスト拡張機能と連携するコマンドレットの拡張機能パラメーター、および仮想マシン スケール セットのパラメーター ‘EncryptFormatAll’ を追加
  • ‘GetAzVmssVMDiskEncryptionStatus’
    • 仮想マシン スケール セットのデータ ディスクの暗号化ステータスを正しく表示するよう、コマンドレットの機能を修正
  • ‘SetAzDiskEncryptionExtension’
    • 2pass から 1pass 暗号化への移行シナリオのコマンドレットの不具合を修正
• Hyper-V を用いて VHD に変換する ‘Add-AzVhd’ を追加
• VM および VMSS コマンドレットに ‘UserData’ パラメーターを追加
• DiskConfig および SnapshotConfig コマンドレットに文字列パラメーター  ‘PublicNetworkAccess’ を追加
• DiskConfig および SnapshotConfig コマンドレットにブール パラメーター ‘AcceleratedNetwork’ を追加
• ユーザーに表示されるよう、PSSnapshot モデルに ‘CompletionPercent’ プロパティを追加

Az.ContainerInstance

• API version 2021-09-01 にアップグレード
  • [重大な変更] ‘New-AzContainerGroup’ の パラメーター タイプ ‘LogAnalyticWorkspaceResourceId’ が Hashtable から String に変更
  • [重大な変更] New-AzContainerGroup’ のパラメーター ‘NetworkProfileId’ を削除、代わりに ‘SubnetId’ を追加
  • [重大な変更] ‘New-AzContainerInstanceObject’ のパラメーター ‘ReadinessProbeHttpGetHttpHeadersName’ と ‘ReadinessProbeHttpGetHttpHeadersValue’ を削除し、代わりに ‘ReadinessProbeHttpGetHttpHeader’ を追加
  • [重大な変更] ‘New-AzContainerInstanceObject’ のパラメーター ‘LivenessProbeHttpGetHttpHeadersName’ と  ‘LivenessProbeHttpGetHttpHeadersValue’ を削除し、代わりに ‘LivenessProbeHttpGetHttpHeader’ を追加
  • ‘New-AzContainerGroup’ に ‘Zone’、’New-AzContainerGroupImageRegistryCredentialObject’ に ‘AcrIdentity’ を追加
  • ‘New-AzContainerGroupImageRegistryCredentialObject’ の ‘Username’ を必須からオプションに変更
• ‘Invoke-AzContainerInstanceCommand’
  • [重大な変更] バックエンドで websocket を接続してコマンドレット出力としてコマンド実行結果を表示 [#15754]
  • コマンドが成功したときに最後の実行結果を取得するために ‘-PassThru’ を追加
  • 現在のPowerShell ウィンドウサイズでデフォルト値を設定するよう、’TerminalSizeCol’ と ‘TerminalSizeRow’ を必須からオプションに変更
• ‘Restart-AzContainerGroup’、’Get-AzContainerInstanceContainerGroupOutboundNetworkDependencyEndpoint’ および ‘New-AzContainerInstanceHttpHeaderObject’ を追加

Az.CosmosDB

• 値が指定されていない場合、AnalyticalStorageSchemaType の値に関する警告が表示されることがある問題を修正
• マネージド Cassandra のサポートを追加

Az.DataFactory

• ADF .Net SDK version 4.28.0 にアップデート

Az.EventHub

• バージョン 1.9.0 以降、’New-AzEventHubKey’ が常にセカンダリ キーではなく新しいプライマリ キーを生成する問題を修正 [#16362]

Az.Functions

• [重大な変更] ‘Update-AzFunctionAppPlan’ で確認のプロンプトが求められる [#16490]
• [重大な変更] ‘Remove-AzFunctionApp’ でプランの最後のアプリである場合、ASPを削除しない [#16487]
• [重大な変更] FunctionApp を作成するには、’FunctionsVersion’ を 4 に設定する [#16426]
• [重大な変更] ‘Update-AzFunctionApp’ で確認のプロンプトが求められる [#14442]
• PowerShell 5.1 上の ‘New-AzFunctionApp’ で関数の作成でエラーになる問題を修正 [#15430]
• ストレージ アカウント SKU ‘Standard_GZRS’ をサポート [#14633]

Az.HDInsight

• コマンドレット ‘New-AzHDInsightCluster’ に新しいパラメーター ‘-Zone’ と ‘-PrivateLinkConfiguration’ を追加
  • 可用性ゾーン機能を持つクラスターを作成をサポートするコマンドレット ‘New-AzHDInsightCluster’ にパラメーター ‘-Zone’ を追加
  • プライベート リンク機能を持つクラスターを作成する際にプライベート リンク構成を追加できるよう、コマンドレット ‘New-AzHDInsightCluster’ にパラメーター ‘-PrivateLinkConfiguration’ を追加
• メモリ内に IP 構成オブジェクトを作成するためのコマンドレット New-AzHDInsightIPConfiguration を追加
• メモリ内にプライベート リンク構成オブジェクトを作成するためのコマンドレット New-AzHDInsightPrivateLinkConfiguration を追加
• 返されたオブジェクトの実際のタイプとの一貫性を維持するために、Set-AzHDInsightClusterDiskEncryptionKey コマンドレットのヘルプ ドキュメントの出力タイプを ‘Microsoft.Azure.Management.HDInsight.Models.Cluster’ から ‘Microsoft.Azure.Commands.HDInsight.Models.AzureHDInsightCluster’ に修正
• 重大な変更 :
  • コマンドレット ‘New-AzHDInsightCluster’ の パラメーター タイプ ‘OSType’ を ‘Microsoft.Azure.Management.HDInsight.Models.OSType’ から ‘System.string’ に変更
  • コマンドレット ‘New-AzHDInsightCluster’ および ‘New-AzHDInsightClusterConfig’ のパラメーター タイプ ‘ClusterTier’ を ‘Microsoft.Azure.Management.HDInsight.Models.ClusterTier’ から ‘System.string’ に変更
  • クラス ‘AzureHDInsightCapabilities’ のプロパティ タイプ ‘VmSizes’ を ‘IDictionary<string, AzureHDInsightVmSizesCapability>’ から ‘IList’ に変更
  • クラス ‘AzureHDInsightCluster’ のプロパティ タイプ ‘AssignedIdentity’ を ‘Microsoft.Azure.Management.HDInsight.Models.ClusterIdentity’ から ‘Microsoft.Azure.Commands.HDInsight.Models.AzureHDInsightClusterIdentity’ に変更

Az.KeyVault

• [重大な変更] Azure RBAC のパターンに従うよう、’PSKeyVaultPermission’ タイプのプロパティの
  名称を変更
• AAD Graph API から MSGraph API に移行
• Permissions パラメーターについて、’All’ オプションを使用すると ‘Purge’ パーミッションが含まれないことを示
  す、メッセージを ‘Set-AzKeyVaultAccessPolicy’ に追加

Az.ManagedServices

• [重大な変更] API version 2020-02-01-preview にアップデート

Az.Monitor

• コマンドレット Get-AzLog の出力として、タイプ string の新しいプロパティ EventName、Category、ResourceProviderName、OperationName、Status、SubStatus が追加 [#15833]
• アクション グループの Event Hub Receiver をサポート [#16348]
• コマンド ‘Get-AzAlertRule’ のデフォルト パラメーター セット ‘GetByResourceGroup’ を追加 [#16356]

Az.Network

• FirewallPolicy に対する PSAzureFirewallPolicyThreatIntelWhitelist の不具合を修正
• 次のコマンドレットにオプション パラメーター ‘-IsSecuritySite’ を追加 :
  • ‘New-AzVpnSite’
• WAF Exclusions の新しい Match Variables サポートを追加
• Virtual Network コマンドレットに Virtual Network Encryption をオンボード
• VPN NAT ルール リソースの NAT ポート範囲パラメーターのサポートを追加
  • ‘New-AzVpnGatewayNatRule.md’
  • ‘Update-AzVpnGatewayNatRule.md’
  • ‘New-AzVirtualNetworkGatewayNatRule.md’
  • ‘Update-AzVirtualNetworkGatewayNatRule.md’
• Application Gateway WAF のPer Rule Exclusions をサポートするために、新しいコマンドレットを追加 :
  • ‘New-AzApplicationGatewayFirewallPolicyExclusionManagedRuleSet’
  • ‘New-AzApplicationGatewayFirewallPolicyExclusionManagedRuleGroup’
  • ‘New-AzApplicationGatewayFirewallPolicyExclusionManagedRule’
  • Exclusions 内で ExclusionManagedRuleSet を構成するためのプロパティを追加するために、コマンドレットをアップデート
    • ‘New-AzApplicationGatewayFirewallPolicyExclusion’
• ファイルから証明書チェーン全体をロードするための ApplicationGateway Trusted ClientCertificate コマンドレットの不具合修正

Az.OperationalInsights

• LinkedStorageAccount コマンドレットで値 ‘Query’ および ‘Alerts’ を持つ DataSourceType の拡張
• [重大な変更] ‘StorageAccountId’ から ‘StorageAccountIds’ に名称変更
  • ‘New-AzOperationalInsightsLinkedStorageAccount’
• [重大な変更] ‘New-AzOperationalInsightsComputerGroup’ によって ‘HttpStatusCode’ の代わりに PSSavedSearch’ を返す
• [重大な変更] ‘Update-AzOperationalInsightsCluster’ によって ‘PSLinkedService’ の代わりに ‘PSCluster ‘を返す
• ワークスペースで値 ‘capacityreservation’ および ‘lacluster’ を持つ Sku の拡張
• ワークスペースに新しいパラメーター ‘SkuCapacity’、’ForceCmkForQuery’、’DisableLocalAuth’ を追加
• 新しいパラメーターを追加
  • ‘DailyQuotaGb’on’Set-AzOperationalInsightsWorkspace’
• StorageInsight コマンドレットに新しいプロパティを追加
  • ‘ETag’
  • ‘Tag’
• 次のコマンドレットに新しいプロパティ ‘StorageAccountResourceId’ を追加 :
  • ‘Set-AzOperationalInsightsStorageInsight’
• 次のコマンドレットに SupportsShouldProcess 属性を追加 :
  • ‘Set-AzOperationalInsightsStorageInsight’
• Table、DataExport、WorkspaceShareKey、PurgeWorkspace、および AvailableServiceTier をサポートする新しいコマンドレットを追加
• クエリ実行時に部分的なエラーを取得するため、’Invoke-AzOperationalInsightsQuery’ の結果に ‘Error’ プロパティを追加 [#16378]

Az.RecoveryServices

• Azure Backup に ‘Get-AzRecoveryServicesBackupItem’、 ‘Get-AzRecoveryServicesBackupContainer’、Get-AzRecoveryServicesBackupJob コマンドレットでサポートされている BackupManagementType の検証セットをアップデート
• Azure Backup に ‘Disable-AzRecoveryServicesBackupProtection’、’Unregister-AzRecoveryServicesBackupContainer’、’Get-AzRecoveryServicesBackupItem’、’Get-AzRecoveryServicesBackupContainer’ コマンドレットの SAPHanaDatabase のサポートを追加
• 重大な変更 : ‘Get-AzRecoveryServicesBackupJob’、’Get-AzRecoveryServicesBackupContainer’ および ‘Get-AzRecoveryServicesBackupItem’ コマンドレットが、’MARS’ の代わりに ‘BackupManagementType MAB’ のみをサポート
• Azure Site Recovery に Azure to Azure プロバイダー用のキャパシティ予約のサポートを追加

Az.Resources

• ‘Get-AzProviderPreviewFeature’、’Register-AzProviderPreviewFeature’ および ‘Unregister-AzProviderPreviewFeature’ コマンドレットを追加
• NamespaceMatch パラメーターの値が空の状態で Get-AzPolicyAlias を実行する際の不具合を修正 [#16370]
• [重大な変更] AAD Graph から Microsoft Graph に移行
• [重大な変更] PSDenyAssignment で返される ‘Id’ を GUID 文字列から完全修飾 ID に変更
• ‘Get-AzDenyAssignment’ のパラメーター ‘Id’ が完全修飾 ID の受け入れを許可
• Bicep モジュールを公開するための新しいコマンドレット ‘Publish-AzBicepModule’ を追加
• ‘*-AzPolicyAssignment’ コマンドレットの ‘AssignIdentity’ パラメーター用に非推奨メッセージを追加
• ‘*-AzPolicyAssignment’ コマンドレットに ‘IdentityType’ および ‘IdentityId’ パラメーターを追加することにより、ポリシー割り当てでユーザー割り当てマネージド ID サポートを追加
• ポリシー割り当てでユーザー割り当てマネージド ID サポートを導入する新しい API version 2021-06-01 を使用するよう、ポリシー コマンドレットをアップデート
• *-AzRoleAssignment の Active Directory オブジェクトに関する情報を取得する際の API 権限を制限 [#16054]

Az.Sql

• ‘Get-AzSqlServerFirewallRule’ の FirewallRuleName ワイルドカード フィルタリングを修正[#16199]
• SQL Server および SQL インスタンス AAD で ActiveDirectoryClient から  MicrosoftGraphClient に移動

Az.StackHCI

• Az.StackHCI が GA

Az.Storage

• パーミッションが null の場合に ‘Get-AzStorageContainerStoredAccessPolicy’ が失敗する問題を修正 [#15644]
• パーミッション i (不変ポリシーの設定) を持つ Blob サービス SAS トークン/アカウント SAS トークンの作成をサポート
  • ‘New-AzStorageBlobSASToken’
  • ‘New-AzStorageContainerSASToken’
  • ‘New-AzStorageAccountSASToken’
• アクセス ポリシーから有効期限なしでコンテナー SAS トークンの作成に失敗、SAS トークンの有効期限を設定する問題を修正 [#16266]
  • ‘New-AzStorageContainerSASToken’
• Get-AzRmStorageShare ShareResourceIdParameterSet からパラメーター -Name を削除
  • ‘Get-AzRmStorageShare’
• バージョン管理で不変ストレージを有効にするため、コンテナーの作成/移行をサポート
  • ‘New-AzRmStorageContainer’
  • ‘Invoke-AzRmStorageContainerImmutableStorageWithVersioningMigration’
• ストレージ Blob 上の不変ポリシーの設定/削除をサポート
  • ‘Set-AzStorageBlobImmutabilityPolicy’
  • ‘Remove-AzStorageBlobImmutabilityPolicy’
• ストレージ Blob 上で訴訟ホールドの有効化/無効化をサポート
  • ‘Set-AzStorageBlobLegalHold’
• バージョン管理によるアカウント レベルの不変を有効にするストレージ アカウントの作成、およびアカウント レベルの不変ポリシーによるストレージア カウントの作成/更新をサポート
  • ‘New-AzStorageAccount’
  • ‘Set-AzStorageAccount’

Az.Websites

• Microsoft.Azure.Management.Websites SDK 3.1.2 にアップデート

コミュニティの貢献者に感謝

• Hiroshi Yoshioka (@hyoshioka0128)
  • “Azure CosmosDB” の誤字を “Azure Cosmos DB” に修正 (#16470)
• Chris (@isjwuk)
  • Update New-AzAutomationSourceControl.md をアップデート (#16366)
• Julian Hüppauff (@jhueppauff)
  • [API Management] 変数の参照を修正 (#16525)
• @toswedlu
  • [CosmosDB] AnalyticalStorageSchemaType の警告メッセージを変更 (#15723)

参考サイト

• Azure/azure-powershell: Microsoft Azure PowerShell
  https://github.com/Azure/azure-powershell
• Releases · Azure/azure-powershell
  https://github.com/Azure/azure-powershell/releases
• PowerShell Module Browser – PowerShell | Microsoft Docs
  https://docs.microsoft.com/en-us/powershell/module/?WT.mc_id=AZ-MVP-4038156