Azure PowerShell での Azure AD から Microsoft Graph への移行に関する変更点

  • [アーティクル]

Azure PowerShell の Az.Resources PowerShell モジュール バージョン 5.1.0 では、ID 関連のコマンドレットに変更が加わります。 Azure AD Graph に依存するコマンドレットは Microsoft Graph への切り替えを行っています。 今回の変更は、Azure AD Graphの廃止の発表を受けて、スムーズな移行を行うために行われるものです。 詳細については、「Azure コマンド ライン ツールでの Azure AD からMicrosoft Graph への移行」を参照してください。

次の例では、Az.Resources Azure PowerShell モジュールの最新バージョンをインストールします。

Install-Module -Name Az.Resources -Repository PSGallery -Scope CurrentUser

変更の一覧については、次の情報を参照してください。

Application

Get-AzAdApplication

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

  • パラメーター IncludeTotalCount はサポートされておらず、削除されました

New-AzAdApplication

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

  • パラメーター Password が削除され、カスタマイズされたパスワードはサポートされなくなりました。作成時にサーバーはシークレット テキストを割り当てます

Remove-AzAdApplication

  • パラメーター InputObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

Update-AzAdApplication

  • パラメーター InputObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から System.Boolean に変更されました

アプリケーション オブジェクトに対する変更

  • ObjectId は Id によって置き換えられました

  • HomePage は、Web 要素内で HomepageUrl によって置き換えられました

  • ApplicationId は AppId によって置き換えられました

  • AvailableToOtherTenants (boolean) が SignInAudience に置き換えられました (4 つの値を持つ文字列: 'AzureADMyOrg'、'AzureADMultipleOrgs'、'AzureADandPersonalMicrosoftAccount'、'PersonalMicrosoftAccount')

    • AzureADMultipleOrgs は AvailableToOtherTenants:$true に相当します

    • AzureAdMyOrg は AvailableToOtherTenants:$false または $null に相当します

  • ApiPermissions は RequiredResourceAccess によって置き換えられました

  • ReplyUrls は、Web 要素内で RedirectUris によって置き換えられました

  • ObjectType は OdataType によって置き換えられました

アプリケーション資格情報

Get-AzAdAppCredential

  • パラメーター ApplicationObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

  • 出力型が Microsoft.Azure.Commands.ActiveDirectory. PSADCredential から以下に変更されました。Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphKeyCredential と Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordCredential

New-AzAdAppCredential

  • パラメーター ApplicationObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

  • 出力型が Microsoft.Azure.Commands.ActiveDirectory. PSADCredential から以下に変更されました。Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphKeyCredential と Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordCredential

  • パラメーター Password が削除され、カスタマイズされたパスワードはサポートされなくなりました。作成時にサーバーはシークレット テキストを割り当てます

Remove-AzAdAppCredential

  • パラメーター ApplicationObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

アプリ資格情報オブジェクトへの変更

パスワード資格情報

  • Password は SecretText によって置き換えられました

キー資格情報

  • CertValue は削除されました

ServicePrincipal

Get-AzAdServicePrincipal

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphServicePrincipal に変更されました

  • パラメーター IncludeTotalCount はサポートされておらず、削除されました。

New-AzAdServicePrincipal

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphServicePrincipal に変更されました

  • パラメーター セット ApplicationWithoutCredentialParameterSet、ApplicationWithPasswordPlainParameterSet、DisplayNameWithoutCredentialParameterSet、DisplayNameWithPasswordPlainParameterSet は、これらの元のパラメーター セットが機能していなかったため、削除されました。

  • セキュリティ上の考慮事項によりパラメーター -Role が指定されない場合、ロール contributor は既定では割り当てられません。

  • パラメーター SkipAssignment は削除されました。

Remove-AzAdServicePrincipal

  • パラメーター ApplicationObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADApplication から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphApplication に変更されました

  • パラメーター InputObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphServicePrincipal に変更されました

Update-AzAdServicePrincipal

  • パラメーター InputObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphServicePrincipal に変更されました

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から System.Boolean に変更されました

サービス プリンシパル オブジェクトへの変更

  • ApplicationId は AppId によって置き換えられました

  • ObjectType は OdataType によって置き換えられました

ServicePrincipal Credential

Get-AzAdSpCredential

  • パラメーター ServicePrincipalObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphServicePrincipal に変更されました

  • 出力型が Microsoft.Azure.Commands.ActiveDirectory. PSADCredential から以下に変更されました。Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphKeyCredential と Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordCredential

New-AzAdSpCredential

  • パラメーター ServicePrincipalObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphServicePrincipal に変更されました

  • 出力型が Microsoft.Azure.Commands.ActiveDirectory. PSADCredential から以下に変更されました。Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphKeyCredential と Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordCredential

Remove-AzAdSpCredential

  • パラメーター ServicePrincipalObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADServicePrincipal から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphServicePrincipal に変更されました

ServicePrincipal 資格情報オブジェクトの変更

パスワード資格情報

  • Password は SecretText によって置き換えられました

キー資格情報

  • CertValue は削除されました

User

Get-AzAdUser

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADUser から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphUser に変更されました

  • パラメーター IncludeTotalCount はサポートされておらず、削除されました

New-AzAdUser

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADUser から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphUser に変更されました

Remove-AzAdUser

  • パラメーター InputObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADUser から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphUser に変更されました

Update-AzAdUser

  • パラメーター InputObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADUser から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphUser に変更されました

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADUser から System.Boolean に変更されました

ユーザー オブジェクトの変更

  • ObjectType は OdataType によって置き換えられました

  • ImmutableId は OnpremisesImmutableId によって置き換えられました

Group

Get-AzAdGroup

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADGroup から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphGroup に変更されました

  • パラメーター IncludeTotalCount はサポートされておらず、削除されました

New-AzAdGroup

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADGroup から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphGroup に変更されました

Remove-AzAdGroup

  • パラメーター InputObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADGroup から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphGroup に変更されました

グループ オブジェクトの変更

  • ObjectType は OdataType によって置き換えられました

グループ メンバー

Get-AzAdGroupMember

  • 出力の種類が、Microsoft.Azure.Commands.ActiveDirectory.PSADObject から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphDirectoryObject に変更されました

  • IncludeTotalCount パラメーターが削除されました。

  • パラメーター GroupObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADGroup から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphGroup に変更されました

重要

現在の Graph API の制限により、Az 7.x の Get-AzAdGroupMember ではサービス プリンシパルは返されません。 回避策については、「Az PowerShell モジュールのトラブルシューティング」を参照してください。

Add-AzAdGroupMember

  • パラメーター GroupObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADGroup から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphGroup に変更されました

Remove-AzAdGroupMember

  • パラメーター GroupObject の入力型が Microsoft.Azure.Commands.ActiveDirectory.PSADGroup から Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphGroup に変更されました