Azure Active Directory PowerShell for Graph 설치

  • 아티클

중요

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 버전을 동일한 컴퓨터에 동시에 설치할 수 없습니다.

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

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

갤러리와 함께 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를 참조하세요.

다음 단계