Microsoft Entra PowerShell 설치

Microsoft Entra PowerShell 모듈을 사용하면 IT 전문가가 Microsoft Entra 리소스를 효율적으로 관리하여 다양한 플랫폼에서 원활한 통합 및 기능을 보장할 수 있습니다. 이 모듈은 관리 작업을 자동화하고 간소화하는 기능을 향상시킵니다.

이 문서에서는 여러 운영 체제에서 Microsoft Entra PowerShell 모듈을 설치, 확인, 업데이트 및 문제를 해결하는 방법을 알아봅니다.

Microsoft Entra PowerShell 모듈은 각각 별도로 설치할 수 있는 하위 모듈이 있는 두 개의 모듈로 분할됩니다. 두 가지 주요 모듈은 다음과 같습니다.

  • Microsoft.Entra - Microsoft Entra PowerShell의 정식 출시 버전 또는 v1.0 버전. Microsoft Graph v1.0 및 Microsoft Graph PowerShell SDK v1.0 리소스를 가리킵니다.
  • Microsoft. Entra.Beta - Beta Microsoft Entra PowerShell의 미리 보기 버전입니다. Microsoft Graph Beta 및 Microsoft Graph PowerShell SDK Beta 리소스를 가리킵니다.

PowerShell 버전 7 이상은 Windows, Linux 및 macOS를 비롯한 모든 플랫폼에서 Microsoft Entra PowerShell 모듈과 함께 사용하는 것이 좋습니다.

Windows Microsoft Entra PowerShell 모듈 설치

모듈에 권장되는 설치 방법 및 PowerShell 버전:

  • PowerShell 갤러리에서 설치
  • Windows PowerShell 5.1 이상 또는 PowerShell 7 이상과 함께 사용합니다.

Windows 필수 구성 요소

  • PowerShell에서 다음 명령을 실행하여 PowerShell 버전을 확인합니다.

    $PSVersionTable.PSVersion

  • 모듈이 설치되어 있는지 확인합니다.

    Get-Module -Name Microsoft.Entra -ListAvailable

  • PowerShell 실행 정책을 원격 서명됨 또는 덜 제한적인 정책으로 설정

    • PowerShell 실행 정책을 확인합니다.

      Get-ExecutionPolicy -List

    • PowerShell 실행 정책을 원격 서명됨으로 설정합니다.

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    실행 정책에 대한 자세한 내용은 about_Execution_Policies를 참조하세요.

설치

모듈을 설치할 때 전체 모듈 또는 특정 하위 모듈을 설치하도록 선택할 수 있습니다. 다음 예제에서는 v1.0 및 Beta 모두에 대해 전체 모듈을 설치하는 방법을 보여줍니다.

Install-Module cmdlet을 사용하여 모듈을 설치합니다.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

필요에 따라 Scope 매개 변수를 사용하여 설치 범위를 변경할 수 있습니다. 이 작업을 수행하려면 관리자 권한이 필요합니다.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

특정 하위 모듈 설치

특정 모듈을 설치하는 것은 Azure Functions 및 Azure Automation 사용하는 등의 자동화 시나리오에 적합합니다.

다음 명령을 실행하여 PowerShell 갤러리 모든 Microsoft.Entra GA/v1.0 모듈을 나열합니다.

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

이 명령은 PowerShell 갤러리 모든 Microsoft Entra PowerShell GA/v1.0 모듈을 나열합니다.

예를 들어 모듈을 Users 설치하려면 다음 명령을 실행합니다.

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

Linux에 Microsoft Entra PowerShell 설치

Linux의 필수 구성 요소

Linux에서 설치

모듈을 설치할 때 전체 모듈 또는 특정 하위 모듈을 설치하도록 선택할 수 있습니다. 다음 예제에서는 전체 모듈을 설치하는 방법을 보여줍니다.

터미널 또는 다른 셸 호스트 애플리케이션을 열고 실행 pwsh 하여 PowerShell을 시작합니다.

Install-Module cmdlet을 사용하여 모듈을 설치합니다.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

필요에 따라 Scope 매개 변수를 사용하여 설치 범위를 변경할 수 있습니다. 이 작업을 수행하려면 관리자 권한이 필요합니다.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

Linux에 특정 하위 모듈 설치

특정 모듈을 설치하는 것은 Azure Functions 및 Azure Automation 사용하는 등의 자동화 시나리오에 적합합니다.

다음 명령을 실행하여 PowerShell 갤러리 모든 Microsoft.Entra GA/v1.0 모듈을 나열합니다.

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

이 명령은 PowerShell 갤러리 모든 Microsoft Entra PowerShell GA/v1.0 모듈을 나열합니다.

예를 들어 모듈을 Users 설치하려면 다음 명령을 실행합니다.

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

macOS에 Microsoft Entra PowerShell 설치

이 문서에서는 macOS의 PowerShell 갤러리 모듈을 설치하는 방법을 설명합니다.

macOS의 필수 구성 요소

macOS에 설치

모듈을 설치할 때 전체 모듈 또는 특정 하위 모듈을 설치하도록 선택할 수 있습니다. 다음 예제에서는 전체 모듈을 설치하는 방법을 보여줍니다.

터미널 또는 다른 셸 호스트 애플리케이션을 열고 실행 pwsh 하여 PowerShell을 시작합니다.

Install-Module cmdlet을 사용하여 Microsoft Entra PowerShell 모듈을 설치합니다.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope CurrentUser -Force -AllowClobber

필요에 따라 Scope 매개 변수를 사용하여 설치 범위를 변경할 수 있습니다. 이 작업을 수행하려면 관리자 권한이 필요합니다.

Install-Module -Name Microsoft.Entra -Repository PSGallery -Scope AllUsers -Force -AllowClobber

macOS에 특정 하위 모듈 설치

특정 모듈을 설치하는 것은 Azure Functions 및 Azure Automation 사용하는 등의 자동화 시나리오에 적합합니다.

다음 명령을 실행하여 PowerShell 갤러리 모든 Microsoft.Entra GA/v1.0 모듈을 나열합니다.

Find-Module -Name "Microsoft.Entra*" -Repository PSGallery |
Where-Object { $_.Name -notmatch "beta" }

이 명령은 PowerShell 갤러리 모든 Microsoft Entra PowerShell GA/v1.0 모듈을 나열합니다.

예를 들어 모듈을 Users 설치하려면 다음 명령을 실행합니다.

Install-Module -Name Microsoft.Entra.Users -Repository PSGallery -Force -AllowClobber

설치된 모듈 버전 및 위치 확인

설치가 완료되면 다음 명령을 사용하여 설치된 하위 모듈, 해당 버전 및 위치를 확인할 수 있습니다.

Get-InstalledModule -Name Microsoft.Entra* |
Where-Object { $_.Name -notmatch "Beta" } | Format-Table Name, Version, InstalledLocation -AutoSize

이 명령은 설치된 Microsoft Entra PowerShell 모듈, 해당 버전 및 설치 위치를 보여줍니다. 출력 버전은 PowerShell 갤러리 최신 버전과 일치해야 합니다. 이제 모듈을 사용할 준비가 되었습니다.

Name                                Version InstalledLocation
----                                ------- -----------------
Microsoft.Entra                     1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra\1.0.1
Microsoft.Entra.Applications        1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Applications\1.0.1
Microsoft.Entra.Authentication      1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Authentication\1.0.1
Microsoft.Entra.DirectoryManagement 1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.DirectoryManagement\1.0.1
Microsoft.Entra.Governance          1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Governance\1.0.1
Microsoft.Entra.Groups              1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Groups\1.0.1
Microsoft.Entra.Reports             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Reports\1.0.1
Microsoft.Entra.SignIns             1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.SignIns\1.0.1
Microsoft.Entra.Users               1.0.1   <PowerShell-Path>\PowerShell\Modules\Microsoft.Entra.Users\1.0.1

예를 들어 Users 특정 하위 코드가 설치되어 있는지 확인하려면 다음을 실행합니다.

Get-InstalledModule -Name Microsoft.Entra.Users

출력 버전은 PowerShell 갤러리 최신 버전과 일치해야 합니다.

Version              Name                                Repository           Description
-------              ----                                ----------           -----------
1.0.1                Microsoft.Entra.Users               PSGallery            Microsoft Entra PowerShell

설치 문제 해결

오류 원인 해결 방법
Install-Module: 매개 변수 이름 AllowPrerelease와 일치하는 매개 변수를 찾을 수 없습니다. 이전 버전의 Install-Module을 사용하고 있습니다. 업그레이드하려면 이 가이드를 따릅니다. 이 문제는 Windows 플랫폼에만 적용됩니다.
종속 모듈 'module-name'은 이 컴퓨터에 설치되어 있지 않습니다. 현재 모듈 'Microsoft.Entra'를 사용하려면 종속 모듈 'module-name'이 설치되어 있는지 확인하세요. Microsoft Entra PowerShell 종속성이 설치되지 않음 설치하려면 이 스크립트를 사용합니다.
Cmdlet이 시스템에 이미 있습니다. 매개 변수 추가 -AllowClobber : Install-Module -Name Microsoft.Entra -Repository PSGallery -Force -AllowClobber
다음 명령은 이 시스템에서 이미 사용할 수 있습니다: 'Enable-EntraAzureADAlias,Get-EntraUnsupportedCommand,Test-EntraScript' 둘 중 하나 Beta 또는 v1.0 이미 설치된 경우 충돌이 발생합니다. 이 문제를 해결하려면 잘못된 모듈 버전을 제거 합니다.

다른 일반적인 설치 및 기타 일반적인 문제에 대한 해결 방법은 모듈 설치 문제 해결을 참조하세요.

로그인

Microsoft Entra PowerShell 모듈을 사용하여 Microsoft Entra 리소스 관리를 시작하려면 PowerShell 세션을 시작하고 Connect-Entra를 실행하여 Microsoft Entra ID 로그인합니다.

Connect-Entra -Scopes 'User.Read.All'
Get-EntraUser -Filter "userPrincipalName eq 'SawyerM@contoso.com'"

Microsoft Entra 자격 증명을 사용하여 열리는 로그인 창에 로그인합니다.

시작하는 모든 새 PowerShell 세션에 대해 이 단계를 반복해야 합니다.

다른 인증 시나리오에 대한 자세한 내용은 더 많은 인증 시나리오를 참조하세요.

모듈 업데이트

모듈이 설치된 경우 다음 단계에 따라 업데이트합니다.

먼저 이 문서의 설치 확인 섹션에 있는 지침을 사용하여 모듈 버전 및 위치를 확인합니다.

최신 버전으로 업데이트

Update-Module을 사용하여 Microsoft Entra PowerShell 모듈의 최신 버전으로 업데이트합니다.

Update-Module -Name Microsoft.Entra -Force

Users와 같은 특정 하위 모듈을 업데이트하려면 다음을 실행합니다.

Update-Module -Name Microsoft.Entra.Users -Force

powerShell 모듈을 사용하여 Update-Module Microsoft Entra 업데이트해도 시스템에서 이전 버전의 모듈이 제거되지는 않습니다.

모듈 제거

모듈을 제거하려면 다음 명령을 실행합니다.

Uninstall-Module -Name Microsoft.Entra -AllVersions -Force

와 같은 Users특정 하위 구성을 제거하려면 다음을 실행합니다.

Uninstall-Module -Name Microsoft.Entra.Users -AllVersions -Force

모든 하위 모듈을 제거하려면 다음을 실행합니다.

$InstalledSubModules = Get-InstalledModule -Name Microsoft.Entra.* |
Where-Object { $_.Name -notmatch "Beta" }
foreach ($module in $InstalledSubModules) {
    Write-Host "Checking for submodule: $($module.Name)" -ForegroundColor Yellow -BackgroundColor DarkBlue
    Uninstall-Module -Name $module.Name -Force -ErrorAction Stop
    Write-Host "Successfully uninstalled submodule: $($module.Name)" -ForegroundColor Green
}

다음 단계

  • Microsoft Entra PowerShell 모듈을 탐색하는 방법에 대한 자세한 내용은 모듈 탐색 문서를 참조하세요.
  • Last updated on