Azure PowerShell 中 Azure AD 至 Microsoft Graph 的移轉變更
Az.Resources
PowerShell 模組的 Azure PowerShell 5.1.0 版本引進了與身分識別有關的指令變更。 依賴 Azure AD Graph 的 Cmdlet 正在轉換至 Microsoft Graph。 為了確保順利轉換,此變更是因應 Azure AD 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.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 認證
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
使用者
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