你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

在 Azure PowerShell 中Microsoft Graph 迁移更改的 Azure AD

Az.Resources Azure PowerShell 的 PowerShell 模块版本 5.1.0 引入了与标识相关的 cmdlet 的更改。 依赖于 Azure AD Graph 的 cmdlet 正在转换为 Microsoft Graph。 鉴于 Azure AD Graph 的停用公告,发生了此更改,以确保平稳过渡。 有关详细信息,请参阅 Azure AD Microsoft Azure 命令行工具的 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已在元素中HomepageUrl替换为Web

  • ApplicationId 已被替换为 AppId

  • AvailableToOtherTenants (布尔值)已替换为 SignInAudience (字符串包含 4 个值:“AzureADMyOrg”、“AzureADMultipleOrgs”、“AzureADandPersonalMicrosoftAccount”、“PersonalMicrosoftAccount”)

    • AzureADMultipleOrgs 等效于 AvailableToOtherTenants:$true

    • AzureAdMyOrg 等效于 AvailableToOtherTenants:$false 或 $null

  • ApiPermissions 已被替换为 RequiredResourceAccess

  • ReplyUrls已在元素中RedirectUris 替换为Web

  • 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.IMicrosoftGraphKeyCredentialMicrosoft.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.IMicrosoftGraphKeyCredentialMicrosoft.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

  • 由于这些原始参数集无法正常运行,因此已删除参数集ApplicationWithoutCredentialParameterSetApplicationWithPasswordPlainParameterSetDisplayNameWithoutCredentialParameterSetDisplayNameWithPasswordPlainParameterSet

  • 由于安全考虑,未提供参数contributor时,不会将角色-Role分配为默认值。

  • 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 凭据

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.IMicrosoftGraphKeyCredentialMicrosoft.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.IMicrosoftGraphKeyCredentialMicrosoft.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 Credential 对象的更改

密码凭据

  • Password 已被替换为 SecretText

密钥凭据

  • CertValue 已删除

用户

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

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

重要

由于当前图形 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