Azure PowerShell에서 Azure AD에서 Microsoft Graph로의 마이그레이션 변경 내용

Azure PowerShell의 Az.Resources PowerShell 모듈 버전 5.1.0에서는 ID 관련 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로 대체되었습니다.

• Web 요소에서 HomePage가 HomepageUrl로 대체되었습니다.

• ApplicationId는 AppId로 대체되었습니다.

• AvailableToOtherTenants(부울)은 SignInAudience(4개의 값이 있는 문자열: 'AzureADMyOrg', 'AzureADMultipleOrgs', 'AzureADandPersonalMicrosoftAccount', 'PersonalMicrosoftAccount')로 대체되었습니다.

  • AzureADMultipleOrgs는 AvailableToOtherTenants:$true와 동일합니다.

  • AzureAdMyOrg는 AvailableToOtherTenants:$false 또는 $null과 동일합니다.

• ApiPermissions는 RequiredResourceAccess로 대체되었습니다.

• Web 요소에서 ReplyUrls가 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로 변경되었습니다.

Important

현재 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로 변경되었습니다.