Azure Active Directory PowerShell for Graph 설치

아티클
04/25/2024

중요

Azure AD Powershell은 2024년 3월 30일에 사용 중단될 예정입니다. 사용 중단 계획에 대한 자세한 내용은 사용 중단 업데이트를 참조하세요. Azure AD 상호 작용하는 데 권장되는 모듈인 Microsoft Graph PowerShell로 계속 마이그레이션하는 것이 좋습니다. 또한 Microsoft Graph PowerShell을 사용하면 모든 Microsoft Graph API에 액세스할 수 있으며 PowerShell 7에서 사용할 수 있습니다. 빈번한 마이그레이션 쿼리에 대한 답변은 마이그레이션 FAQ를 참조하세요.

사용자 관리, 도메인 관리 및 Single Sign-On 구성과 같은 Azure AD 관리 작업에 Graph용 Azure Active Directory PowerShell 모듈 버전을 사용할 수 있습니다. 여기에 나열된 cmdlet은 Azure Active Directory PowerShell 버전 1.0의 일부인 MSOnline cmdlet과 다릅니다.

Azure AD PowerShell for Graph 모듈에는 공개 미리 보기 버전과 GA(일반 공급) 버전의 두 가지 버전이 있습니다. 프로덕션 시나리오에는 공개 미리 보기 버전을 사용하지 않는 것이 좋습니다.

PowerShell 갤러리 다음을 사용하여 모듈을 다운로드합니다.

Graph용 Azure Active Directory PowerShell 릴리스 버전 기록

Azure AD 모듈 및 Azure AD 미리 보기 모듈의 릴리스 기록은 그래프용 azure Active Directory powershell: 버전 릴리스 기록입니다.

Azure AD 모듈 설치

사전 요구 사항

Azure AD 모듈은 기본 버전의 Microsoft .NET Framework 및 Windows PowerShell 다음 Windows 운영 체제에서 지원됩니다.

Windows 8.1
Windows 8
Windows 7

Windows Server 2012 R2,
Windows Server 2012
Windows Server 2008 R2.

참고

Azure AD PowerShell 모듈은 PowerShell 7과 호환되지 않습니다. PowerShell 5.1에서만 지원됩니다.

모듈의 일반 공급 버전을 설치하려면 다음을 실행합니다.

Install-Module AzureAD

공개 미리 보기 릴리스를 설치하려면 다음을 실행합니다.

Install-module AzureADPreview

미리 보기 버전과 GA 버전을 동일한 컴퓨터에 동시에 설치할 수 없습니다.

PowerShell 갤러리 정보

Azure AD 모듈은 PowerShell 갤러리 사용하여 배포됩니다. 갤러리에서 항목을 설치하려면 Windows 10, WMF(Windows Management Framework) 5.0 또는 MSI 기반 설치 관리자(PowerShell 3 및 4용)에서 사용할 수 있는 최신 버전의 PowerShellGet 모듈이 필요합니다.

최신 PowerShellGet 모듈을 사용할 경우 다음을 수행할 수 있습니다.

Find-Module 및 Find-Script를 사용하여 갤러리에서 항목 검색
Save-Module 및 Save-Script를 사용하여 갤러리의 항목을 시스템에 저장
Install-Module 및 Install-Script를 사용하여 갤러리에서 항목 설치
Publish-Module 및 Publish-Script를 사용하여 갤러리에 항목 업로드
Register-PSRepository를 사용하여 사용자 지정 리포지토리 추가

갤러리와 함께 PowerShellGet 명령을 사용하는 방법에 대한 자세한 내용은 시작 페이지를 참조하세요. Update-Help -Module PowerShellGet을 실행하여 이러한 명령에 대한 로컬 도움말을 설치할 수도 있습니다.

지원되는 운영 체제

PowerShellGet 모듈을 사용하려면 PowerShell 3.0 이상이 있어야 합니다.

따라서 PowerShellGet에는 다음 운영 체제 중 하나가 필요합니다.

윈도우 10
Windows 8.1 Pro
Windows 8.1 Enterprise
Windows 7 SP1
Windows Server 2016 TP5
Windows Server 2012 R2
Windows Server 2008 R2 SP1

PowerShellGet을 사용하려면 .NET Framework 4.5 이상도 있어야 합니다. .NET Framework 4.5 이상은 여기에서 설치할 수 있습니다.

Azure AD 모듈 업데이트

컴퓨터에 설치된 모듈 버전을 검사 다음 명령을 실행합니다.

Get-Module AzureADPreview

ModuleType Version Name                ExportedCommands
---------- ------- ----                ----------------
Binary     2.0.0.7 azureadpreview     {Add-AzureADAdmini...

컴퓨터에서 Azure AD PowerShell 모듈의 버전을 업데이트하려면 Install-Module cmdlet을 다시 실행합니다.

Install-Module AzureADPreview

이 명령은 PowerShell 갤러리에서 최신 버전을 사용할 수 있는지 확인합니다. 그렇다면 컴퓨터에 설치된 것보다 최신 버전입니다.

Azure에 연결

이 문서에서 설명하는 cmdlet을 실행하려면 먼저 온라인 서비스에 연결해야 합니다. 이렇게 하려면 Windows PowerShell 명령 프롬프트에서 Connect-AzureAD cmdlet을 실행합니다. 그러면 자격 증명을 묻는 메시지가 표시됩니다. 원하는 경우 사전에 자격 증명을 제공할 수 있습니다. 예를 들어

$AzureAdCred = Get-Credential
Connect-AzureAD -Credential $AzureAdCred

첫 번째 명령은 자격 증명을 묻는 메시지를 표시하고, 이 자격 증명을 $AzureAdCred로 저장합니다. 다음 명령은 $azureadcred와 같은 자격 증명을 사용하여 서비스에 연결합니다.

참고

Azure AD 및 Azure AD 미리 보기 모듈은 서로 다른 명명 규칙(예: 및 -AzureADMS)이 있는 cmdlet으로 구성됩니다. -AzureAD cmdlet은 -AzureAD Azure AD Graph 엔드포인트 https://graph.windows.net 에 연결하고 -AzureADMS cmdlet은 Microsoft Graph 엔드포인트 graph.microsoft.com를 호출합니다. 한 엔드포인트에서 다른 엔드포인트로 호출을 변경하고 자격 증명을 다시 입력하라는 메시지가 표시되지 않으면 인증이 자동으로 처리됩니다.

Azure Active Directory의 특정 환경에 연결하려면 다음과 같이 AzureEnvironment 매개 변수를 사용합니다.

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

이 예제에서는 PowerShell 세션을 독일어 AzureAD 환경에 연결합니다. 자세한 내용은 Connect-AzureAD를 참조하세요.

다음 단계

새 기능 및 개선 사항을 참조하세요.

다음을 통해 공유