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

  • 發行項

Az.Resources Azure PowerShell 的 PowerShell 模組 5.1.0 版引進身分識別相關 Cmdlet 的變更。 依賴 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 （boolean） 已取代為 SignInAudience （string with 4 values： '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.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、 、 DisplayNameWithoutCredentialParameterSetApplicationWithPasswordPlainParameterSetDisplayNameWithPasswordPlainParameterSet 已移除，因為這些原始參數集無法運作。

  • 當因為安全性考慮而未提供參數-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.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 Credential 對象的變更

密碼認證

  • 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

群組

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

Group 對象的變更

  • 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