그래프용 Azure Active Directory PowerShell

  • 아티클

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

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

Azure AD PowerShell for Graph 미리 보기 모듈은 AzureADPreview 페이지의 PowerShell 갤러리 다운로드할 수 있습니다.

Azure AD PowerShell for Graph 일반 공급 모듈은 AzureAD 페이지의 PowerShell 갤러리 다운로드할 수 있습니다.

Azure AD 모듈 설치

Azure AD PowerShell for Graph 모듈은 기본 버전의 Microsoft .NET Framework 및 Windows PowerShell Windows 운영 체제에서 지원됩니다. Windows 8.1, Windows 8, Windows 7, Windows Server 2012 R2, Windows Server 2012 또는 Windows Server 2008 R2.

설치하기 위한 모든 필수 구성 요소가 컴퓨터에 있는 경우 이 컴퓨터에 모듈의 일반 사용 가능 버전을 설치하려면 다음을 실행하면 됩니다

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 모듈 업데이트

다음 명령을 실행하여 컴퓨터에 설치한 모듈의 버전을 확인할 수 있습니다.

PS C:\WINDOWS\system32> Get-Module AzureADPreview

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

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

PS C:\WINDOWS\system32> Install-Module AzureADPreview

이 명령은 PowerShell 갤러리를 검사하여 최신 버전을 사용할 수 있는지 확인하고, PowerShell 갤러리의 버전이 컴퓨터에 설치된 버전보다 최신인 경우 컴퓨터에 해당 버전을 설치합니다.

Azure에 연결

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

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

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

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

Connect-AzureAD -AzureEnvironment "AzureGermanyCloud"

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

제안?

Azure Active Directory PowerShell을 개선하는 방법에 대한 제안이 있는 경우 주저하지 말고 알려주세요.

Windows PowerShell에 대한 자세한 정보

Windows PowerShell은 시스템 관리를 위해 설계된 작업 기반 명령줄 셸 및 스크립팅 언어입니다. 텍스트를 받아들이고 반환하는 대부분의 셸과는 달리 Windows PowerShell은 .NET Framework를 기반으로 하여 .NET Framework 개체를 받아들이고 반환합니다.

Windows PowerShell은 셸에 기본 제공되는 간단한 단일 함수 명령줄 도구인 cmdlet("커맨드렛"으로 읽음)의 개념을 도입합니다. Cmdlet에는 Get-Help, Get-Process 및 Start-Service와 같이 대시(-)로 구분된 동사와 명사로 구성된 명명 규칙이 사용됩니다. Windows PowerShell에는 기본 핵심 cmdlet이 100개 이상 포함되어 있습니다.

모든 cmdlet에 대한 자세한 내용이나 구문에 대해서는 Get-Help <cmdlet name> 명령을 사용합니다. 여기서 <cmdlet name>은 조사하려는 cmdlet의 이름입니다. 자세한 내용을 보려면 다음 명령 중 하나를 실행할 수 있습니다.

  • Get-Help <cmdlet name> -Detailed
  • Get-Help <cmdlet name> -Examples
  • Get-Help <cmdlet name> -Full

Windows PowerShell에 대한 자세한 내용은 Windows PowerShell 시작을 참조하세요.