共用方式為


Azure PowerShell 中 Azure AD 至 Microsoft Graph 的移轉變更

Az.Resources PowerShell 模組的 Azure PowerShell 5.1.0 版本引進了與身分識別有關的指令變更。 依賴 Azure AD Graph 的 Cmdlet 正在轉換至 Microsoft Graph。 為了確保順利轉換,此變更是因應 Azure AD Graph即將淘汰的 公告而實施。 如需詳細資訊,請參閱 針對 Azure 命令列工具進行的 Azure AD 到 Microsoft Graph 遷移

下列範例會安裝最新版的 Az.Resources Azure PowerShell 模組。

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

如需變更清單,請參閱下列資訊。

應用

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 已在 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.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 已移除,因為這些原始參數集無法運作。

  • 當因為安全性考慮而未提供參數 -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 認證

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 憑證物件的變更

密碼憑證

  • 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

重要

由於目前 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