PowerShell을 사용하여 Microsoft 365에 연결
이 문서는 Microsoft 365 Enterprise와 Office 365 Enterprise에 모두 적용됩니다.
Microsoft 365용 PowerShell을 사용하여 명령줄에서 Microsoft 365 설정을 관리할 수 있습니다. PowerShell에 연결하려면 필수 소프트웨어를 설치하고 Microsoft 365 조직에 연결하면 됩니다.
Microsoft 365 및 관리자 계정, 그룹 및 라이선스에 연결하는 데 사용할 수 있는 두 가지 버전의 PowerShell 모듈이 있습니다.
- Azure Active Directory PowerShell for Graph(cmdlet의 이름에 AzureAD 포함)
- cmdlet이 이름에 Msol을 포함하는 Windows PowerShell Microsoft Azure Active Directory 모듈
현재 Graph용 Azure Active Directory PowerShell 모듈은 사용자, 그룹 및 라이선스 관리를 위한 Windows PowerShell 모듈에 대한 Microsoft Azure Active Directory 모듈의 기능을 완전히 대체하지는 않습니다. 어떤 경우에는, 두 버전을 모두 사용해야 합니다. 동일한 컴퓨터에 두 버전을 안전하게 설치할 수 있습니다.
참고
Microsoft 365 관리 센터에서 Azure Cloud Shell로 연결할 수도 있습니다.
시작하기 전에 알아야 할 사항은 무엇인가요?
참고
Azure Active Directory 모듈은 Microsoft Graph PowerShell SDK로 대체됩니다. Microsoft Graph PowerShell SDK를 사용하여 모든 Microsoft Graph API에 액세스할 수 있습니다. 자세한 내용은 Microsoft Graph PowerShell SDK 시작하기를 참조하세요.
운영 체제
64비트 버전의 Windows를 사용해야 합니다. Windows PowerShell 32비트 버전의 Microsoft Azure Active Directory 모듈에 대한 지원은 2014년에 종료되었습니다.
다음 Windows 버전을 사용할 수 있습니다.
Windows 10, Windows 8.1, Windows 8 또는 Windows 7 서비스팩 1(SP1)
Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 또는 Windows Server 2008 R2 SP1
참고
Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012 및 Windows Server 2008 R2 SP1의 경우, Windows Management Framework 5.1을 다운로드하고 설치합니다.
PowerShell
Azure Active Directory PowerShell for Graph 모듈의 경우 PowerShell 버전 5.1을 사용해야 합니다.
Windows PowerShell 모듈용 Microsoft Azure Active Directory 모듈의 경우 PowerShell 버전 5.1 이상을 PowerShell 버전 6까지 사용해야 합니다. PowerShell 버전 7은 사용할 수 없습니다.
참고
이러한 절차는 Microsoft 365 관리자 역할의 구성원인 사용자를 대상으로 합니다. 자세한 내용은 관리자 역할 정보를 참조하세요.
그런 다음, Azure Active Directory PowerShell for Graph 모듈에 연결합니다.
Azure Active Directory PowerShell for Graph 모듈의 명령에는 cmdlet 이름에 AzureAD가 있습니다. Azure Active Directory PowerShell for Graph 모듈 또는 Azure PowerShell을 설치할 수 있습니다.
Azure Active Directory PowerShell for Graph 모듈에서 새 cmdlet을 필요로 하는 프로시저의 경우, 이러한 단계를 사용해서 모듈을 설치하고 Microsoft 365 구독에 연결할 수 있습니다.
참고
Windows의 여러 버전에 대한 지원 정보는 Azure Active Directory PowerShell for Graph 모듈을 참조하세요.
1단계: 필수 소프트웨어 설치
이러한 단계는 컴퓨터에서 한 번만 필요합니다. 그러나 소프트웨어를 정기적으로 업데이트해야 할 수 있습니다.
Windows PowerShell 명령 프롬프트 창을 엽니다.
다음 명령을 실행합니다.
Install-Module -Name AzureAD
기본적으로 PowerShell 갤러리(PSGallery)는 PowerShellGet을 위한 신뢰할 수 있는 리포지토리로 구성되지 않습니다. PSGallery를 처음 사용하면 다음 메시지가 표시됩니다.
Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the `Set-PSRepository` cmdlet.
Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
설치를 계속하려면 예 또는 모두 예로 대답하십시오.
이 명령을 실행하여 모듈을 가져옵니다.
Import-Module AzureAD
2단계: Microsoft 365 구독의 Microsoft Entra ID에 연결
계정 이름 및 암호 또는 다단계 인증을 사용하여 Microsoft 365 구독의 Microsoft Entra ID에 연결하려면 Windows PowerShell 명령 프롬프트에서 이러한 명령 중 하나를 실행합니다. (관리자일 필요는 없습니다.)
| Office 365 클라우드 | 명령 |
|---|---|
| Office 365 Worldwide(+GCC) | Connect-AzureAD |
| 21 Vianet이 운영하는 Office 365 | Connect-AzureAD -AzureEnvironmentName AzureChinaCloud |
| Office 365 Germany | Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud |
| Office 365 미국 국방부(DoD) 및 Office 365 미국 정부 GCC High | Connect-AzureAD -AzureEnvironmentName AzureUSGovernment |
계정에 로그인하세요 대화 상자에서, Microsoft 365 회사 또는 학교 계정 사용자 이름 및 암호를 입력한 다음, 확인을 선택하세요.
다단계 인증을 사용하는 경우 지침에 따라 확인 코드와 같은 추가 인증 정보를 제공합니다.
연결 후 Azure Active Directory PowerShell for Graph 모듈의 cmdlet을 사용할 수 있습니다.
Windows PowerShell Microsoft Azure Active Directory 모듈과 연결
참고
Windows PowerShell 대한 Microsoft Azure Active Directory 모듈의 cmdlet의 이름에는 Msol이 있습니다.
PowerShell 버전 7 이상에서는 이름에 Msol이 있는 Windows PowerShell 모듈 및 cmdlet에 대한 Microsoft Azure Active Directory 모듈을 지원하지 않습니다. PowerShell 버전 7 이상의 경우 Microsoft Graph PowerShell SDK를 사용해야 합니다.
PowerShell Core는 이름에 Msol이 있는 Windows PowerShell 모듈 및 cmdlet에 대한 Microsoft Azure Active Directory 모듈을 지원하지 않습니다. Windows PowerShell에서 이러한 cmdlet을 실행합니다.
1단계: 필수 소프트웨어 설치
이러한 단계는 컴퓨터에서 한 번만 필요합니다. 그러나 소프트웨어를 정기적으로 업데이트해야 할 수 있습니다.
Windows 10을 사용하는 것이 아니라면 32비트 버전의 Microsoft Online Services 로그인 도우미를 설치합니다. IT 전문가용 Microsoft Online Services 로그인 도우미 RTW를 설치합니다.
다음 단계에 따라 Windows PowerShell Microsoft Azure Active Directory 모듈을 설치하고 가져옵니다.
- 관리자 권한의 Windows PowerShell 명령 프롬프트를 엽니다(관리자 권한으로 Windows PowerShell 실행).
- Install-Module MSOnline 명령을 실행합니다.
- NuGet 공급자를 설치할지 묻는 메시지가 표시되면 Y를 입력하고 Enter 키를 누릅니다.
- PSGallery에서 모듈을 설치할지 묻는 메시지가 표시되면 Y를 입력하고 Enter 키를 누릅니다.
- Import-Module MSOnline 명령을 실행하여 모듈을 가져옵니다.
2단계: Microsoft 365 구독의 Microsoft Entra ID에 연결
계정 이름 및 암호 또는 다단계 인증을 사용하여 Microsoft 365 구독의 Microsoft Entra ID에 연결하려면 Windows PowerShell 명령 프롬프트에서 이러한 명령 중 하나를 실행합니다. (관리자일 필요는 없습니다.)
| Office 365 클라우드 | 명령 |
|---|---|
| Office 365 Worldwide(+GCC) | Connect-MsolService |
| 21 Vianet이 운영하는 Office 365 | Connect-MsolService -AzureEnvironment AzureChinaCloud |
| Office 365 Germany | Connect-MsolService -AzureEnvironment AzureGermanyCloud |
| Office 365 미국 국방부(DoD) 및 Office 365 미국 정부 GCC High | Connect-MsolService -AzureEnvironment USGovernment |
계정에 로그인하세요 대화 상자에서, Microsoft 365 회사 또는 학교 계정 사용자 이름 및 암호를 입력한 다음, 확인을 선택하세요.
다단계 인증을 사용하는 경우 지침에 따라 확인 코드와 같은 추가 인증 정보를 제공합니다.
작동 여부는 어떻게 확인하나요?
오류 메시지가 표시되지 않으면 성공적으로 연결된 것입니다. 빠른 테스트를 위해 Get-MsolUser와 같은 Microsoft 365 cmdlet을 실행하고 결과를 확인합니다.
오류 메시지가 표시되는 경우 다음 문제를 확인하세요.
가장 흔한 문제는 암호를 잘못 입력한 경우입니다. 2단계를 다시 실행하고 사용자 이름과 암호를 입력할 때 신중하게 확인하세요.
Windows PowerShell Microsoft Azure Active Directory 모듈을 사용하려면 Microsoft .NET Framework 3.5가 필요합니다.컴퓨터에서 x를 사용할 수 있습니다. 컴퓨터에 최신 버전(예: 4 또는 4.5)이 설치되어 있는 것 같습니다.x). 이전 버전의 .NET Framework와 이전 버전과의 호환성을 사용하거나 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.
Windows Server 2012 또는 Windows Server 2012 R2의 경우 역할 및 기능 추가 마법사를 사용하여 .NET Framework 3.5를 사용 가능하도록 설정을 참조하세요.
Windows 7 또는 Windows Server 2008 R2의 경우 Windows PowerShell Azure Active Directory 모듈을 열 수 없습니다를 참조하세요.
Windows 10, Windows 8.1 및 Windows 8의 경우, Windows 10, Windows 8.1 및 Windows 8에 .NET Framework 3.5 설치를 참조하세요.
Windows PowerShell Microsoft Azure Active Directory 모듈의 버전이 최신이 아닐 수 있습니다. 검사 Microsoft 365용 PowerShell 또는 Windows PowerShell Microsoft Azure Active Directory 모듈에서 다음 명령을 실행합니다.
(Get-Item C:\Windows\System32\WindowsPowerShell\v1.0\Modules\MSOnline\Microsoft.Online.Administration.Automation.PSModule.dll).VersionInfo.FileVersion반환된 버전 번호가 1.0.8070.2보다 낮은 경우 Windows PowerShell 대한 Microsoft Azure Active Directory 모듈을 제거하고 위의 1단계에서 설치합니다.
연결 오류 메시지가 표시되면, "Connect-MsolService: 형식 예외가 발생함" 오류를 참조하세요.
"Get-Item: 경로를 찾을 수 없음" 오류 메시지가 표시되면, 다음 명령을 실행하세요.
(dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
Azure Cloud Shell에 연결
Microsoft 365 관리 센터에서 Azure Cloud Shell에 연결하여 사용하려면 작업 표시줄의 오른쪽 위 모서리에서 PowerShell 창 아이콘을 선택합니다. Azure Cloud Shell 시작 창에서 PowerShell을 선택합니다.
Microsoft 365 구독에 연결된 조직에 대한 활성 Azure 구독이 필요합니다. 해당 구독이 아직 없는 경우 만들 수 있습니다. Azure 구독이 있으면 PowerShell 명령 및 스크립트를 실행할 수 있는 PowerShell 창이 열립니다.
자세한 내용은 Azure Cloud Shell을 참조하세요.