PowerShell을 사용하여 Microsoft 365에 연결Connect to Microsoft 365 with PowerShell

이 문서는 Microsoft 365 Enterprise와 Office 365 Enterprise에 모두 적용됩니다.This article applies to both Microsoft 365 Enterprise and Office 365 Enterprise.

Microsoft 365용 PowerShell을 사용하여 명령줄에서 Microsoft 365 설정을 관리할 수 있습니다.PowerShell for Microsoft 365 enables you to manage your Microsoft 365 settings from the command line. PowerShell에 연결하려면 필수 소프트웨어를 설치하고 Microsoft 365 조직에 연결하면 됩니다.To connect to PowerShell, just install the required software and then connect to your Microsoft 365 organization.

Microsoft 365 및 관리자 계정, 그룹 및 라이선스에 연결하는 데 사용할 수 있는 두 가지 버전의 PowerShell 모듈이 있습니다.There are two versions of the PowerShell module that you can use to connect to Microsoft 365 and administer user accounts, groups, and licenses:

  • Azure Active Directory PowerShell for Graph(cmdlet의 이름에 AzureAD 포함)Azure Active Directory PowerShell for Graph, whose cmdlets include AzureAD in their name
  • Windows PowerShell용 Microsoft Azure AD 모듈(cmdlet의 이름에 Msol 포함)Microsoft Azure Active Directory Module for Windows PowerShell, whose cmdlets include Msol in their name

현재, Azure Active Directory PowerShell for Graph 모듈이 사용자, 그룹 및 라이선스 관리를 위한 Windows PowerShell용 Microsoft Azure Active Directory 모듈을 완전히 대체하는 것은 아닙니다.Currently, the Azure Active Directory PowerShell for Graph module doesn't completely replace the functionality of the Microsoft Azure Active Directory Module for Windows PowerShell module for user, group, and license administration. 어떤 경우에는, 두 버전을 모두 사용해야 합니다.In some cases, you need to use both versions. 동일한 컴퓨터에 두 버전을 안전하게 설치할 수 있습니다.You can safely install both versions on the same computer.

시작하기 전에 알아야 할 사항은 무엇인가요?What do you need to know before you begin?

운영 체제Operating system

64비트 버전의 Windows를 사용해야 합니다.You must use a 64-bit version of Windows. 32비트 버전의 Windows PowerShell용 Microsoft Azure Active Directory 모듈 지원은 2014년에 종료됩니다.Support for the 32-bit version of the Microsoft Azure Active Directory Module for Windows PowerShell ended in 2014.

다음 Windows 버전을 사용할 수 있습니다.You can use the following versions of Windows:

  • Windows 10, Windows 8.1, Windows 8 또는 Windows 7 서비스팩 1(SP1)Windows 10, Windows 8.1, Windows 8, or Windows 7 Service Pack 1 (SP1)

  • Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012 또는 Windows Server 2008 R2 SP1Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, or 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을 다운로드하고 설치합니다. For Windows 8.1, Windows 8, Windows 7 Service Pack 1 (SP1), Windows Server 2012 R2, Windows Server 2012, and Windows Server 2008 R2 SP1, download and install the Windows Management Framework 5.1.

PowerShellPowerShell

  • Azure Active Directory PowerShell for Graph 모듈의 경우 PowerShell 버전 5.1 이상을 사용해야 합니다.For the Azure Active Directory PowerShell for Graph module, you must use PowerShell version 5.1 or later.

  • Windows PowerShell용 Microsoft Azure Active Directory 모듈의 경우 PowerShell 버전 5.1 이상 PowerShell 버전 6 이하를 사용해야 합니다.For the Microsoft Azure Active Directory Module for Windows PowerShell module, you must use PowerShell version 5.1 or later, up to PowerShell version 6. PowerShell 버전 7은 사용할 수 없습니다.You can't use PowerShell version 7.

참고

이러한 절차는 Microsoft 365 관리자 역할의 구성원인 사용자를 대상으로 합니다.These procedures are intended for users who are members of a Microsoft 365 admin role. 자세한 내용은 관리자 역할 정보를 참조하세요.For more information, see About admin roles.

그런 다음, Azure Active Directory PowerShell for Graph 모듈에 연결합니다.Connect with the Azure Active Directory PowerShell for Graph module

Azure Active Directory PowerShell for Graph 모듈의 명령에는 cmdlet 이름에 AzureAD 가 있습니다.Commands in the Azure Active Directory PowerShell for Graph module have AzureAD in their cmdlet name. Azure Active Directory PowerShell for Graph 모듈 또는 Azure PowerShell을 설치할 수 있습니다.You can install the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

Azure Active Directory PowerShell for Graph 모듈에서 새 cmdlet을 필요로 하는 프로시저의 경우, 이러한 단계를 사용해서 모듈을 설치하고 Microsoft 365 구독에 연결할 수 있습니다.For procedures that require the new cmdlets in the Azure Active Directory PowerShell for Graph module, follow these steps to install the module and connect to your Microsoft 365 subscription.

참고

Windows의 여러 버전에 대한 지원 정보는 Azure Active Directory PowerShell for Graph 모듈을 참조하세요.For information about support for different versions of Windows, see Azure Active Directory PowerShell for Graph module .

1단계: 필수 소프트웨어 설치Step 1: Install the required software

이러한 단계는 컴퓨터에서 한 번만 필요합니다.These steps are required only one time on your computer. 그러나 소프트웨어를 정기적으로 업데이트해야 할 수 있습니다.But you'll likely need to update the software periodically.

  1. 관리자 권한의 Windows PowerShell 명령 프롬프트 창을 엽니다(관리자 권한으로 Windows PowerShell 실행).Open an elevated Windows PowerShell Command Prompt window (run Windows PowerShell as an administrator).

  2. 다음 명령을 실행합니다.Run this command:

    Install-Module -Name AzureAD
    

    신뢰할 수 없는 리포지토리에서 모듈을 설치할지 묻는 메시지가 표시되면 Y 를 입력하고 Enter 키를 누릅니다.If you're prompted to install a module from an untrusted repository, type Y and press Enter.

2단계: Microsoft 365 구독을 위해 Azure AD에 연결Step 2: Connect to Azure AD for your Microsoft 365 subscription

계정 이름 및 암호를 사용하여 또는 다단계 인증을 사용하여 Microsoft 365 구독을 위해 Azure AD(Azure Active Directory)에 연결하려면, Windows PowerShell 명령 프롬프트에서 이 명령 중 하나를 실행하세요.To connect to Azure Active Directory (Azure AD) for your Microsoft 365 subscription with an account name and password or with multi-factor authentication, run one of these commands from a Windows PowerShell command prompt. (관리자일 필요는 없습니다.)(It doesn't have to be elevated.)

Office 365 클라우드Office 365 cloud 명령Command
Office 365 Worldwide(+GCC)Office 365 Worldwide (+GCC) Connect-AzureAD
21 Vianet이 운영하는 Office 365Office 365 operated by 21 Vianet Connect-AzureAD -AzureEnvironmentName AzureChinaCloud
Office 365 GermanyOffice 365 Germany Connect-AzureAD -AzureEnvironmentName AzureGermanyCloud
Office 365 미국 국방부(DoD) 및 Office 365 미국 정부 GCC HighOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-AzureAD -AzureEnvironmentName AzureUSGovernment

계정에 로그인하세요 대화 상자에서, Microsoft 365 회사 또는 학교 계정 사용자 이름 및 암호를 입력한 다음, 확인 을 선택하세요.In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then select OK.

다단계 인증을 사용하는 경우 지침에 따라 확인 코드와 같은 추가 인증 정보를 제공합니다.If you're using multi-factor authentication, follow the instructions to provide additional authentication information, such as a verification code.

연결 후 Azure Active Directory PowerShell for Graph 모듈의 cmdlet을 사용할 수 있습니다.After you connect, you can use the cmdlets for the Azure Active Directory PowerShell for Graph module.

Windows PowerShell용 Microsoft Azure Active Directory 모듈에 연결Connect with the Microsoft Azure Active Directory Module for Windows PowerShell

참고

Windows PowerShell용 Microsoft Azure Active Directory 모듈의 명령에는 cmdlet 이름에 sol 이 있습니다.Cmdlets in the Microsoft Azure Active Directory Module for Windows PowerShell have Msol in their name.

PowerShell 버전 7 이상은 Windows PowerShell용 Microsoft Azure Active Directory 모듈 및 이름에 Msol 이 있는 cmdlet을 지원하지 않습니다.PowerShell version 7 and later don't support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. PowerShell 버전 7 이상의 경우 Azure Active Directory PowerShell for Graph 모듈 또는 Azure PowerShell을 사용해야 합니다.For PowerShell version 7 and later, you must use the Azure Active Directory PowerShell for Graph module or Azure PowerShell.

PowerShell Core는 Windows PowerShell용 Microsoft Azure Active Directory 모듈 및 이름에 Msol 이 있는 cmdlet을 지원하지 않습니다.PowerShell Core doesn't support the Microsoft Azure Active Directory Module for Windows PowerShell module and cmdlets with Msol in their name. Windows PowerShell에서 이러한 cmdlet을 실행합니다.Run these cmdlets from Windows PowerShell.

1단계: 필수 소프트웨어 설치Step 1: Install the required software

이러한 단계는 컴퓨터에서 한 번만 필요합니다.These steps are required only one time on your computer. 그러나 소프트웨어를 정기적으로 업데이트해야 할 수 있습니다.But you'll likely need to update the software periodically.

  1. Windows 10을 사용하는 것이 아니라면 64비트 버전의 Microsoft Online Services 로그인 도우미를 설치합니다.IT 전문가용 Microsoft Online Services 로그인 도우미 RTW를 설치합니다.If you're not running Windows 10, install the 64-bit version of the Microsoft Online Services Sign-in Assistant: Microsoft Online Services Sign-in Assistant for IT Professionals RTW.

  2. 다음 단계에 따라 Windows PowerShell용 Microsoft Azure Active Directory 모듈을 설치합니다.Follow these steps to install the Microsoft Azure Active Directory Module for Windows PowerShell:

    1. 관리자 권한의 Windows PowerShell 명령 프롬프트를 엽니다(관리자 권한으로 Windows PowerShell 실행).Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).
    2. Install-Module MSOnline 명령을 실행합니다.Run the Install-Module MSOnline command.
    3. NuGet 공급자를 설치할지 묻는 메시지가 표시되면 Y 를 입력하고 Enter 키를 누릅니다.If you're prompted to install the NuGet provider, type Y and press Enter.
    4. PSGallery에서 모듈을 설치할지 묻는 메시지가 표시되면 Y 를 입력하고 Enter 키를 누릅니다.If you're prompted to install the module from PSGallery, type Y and press Enter.

2단계: Microsoft 365 구독을 위해 Azure AD에 연결Step 2: Connect to Azure AD for your Microsoft 365 subscription

계정 이름 및 암호를 사용하여 또는 MFA(다중 요소 인증)을 사용하여 Microsoft 365 구독을 위해 Azure AD에 연결하려면, Windows PowerShell 명령 프롬프트(관리자 권한이 아니어도 됨)에서 이 명령 중 하나를 실행하세요.To connect to Azure AD for your Microsoft 365 subscription with an account name and password or with multi-factor authentication, run one of these commands from a Windows PowerShell command prompt. (관리자일 필요는 없습니다.)(It doesn't have to be elevated.)

Office 365 클라우드Office 365 cloud 명령Command
Office 365 Worldwide(+GCC)Office 365 Worldwide (+GCC) Connect-MsolService
21 Vianet이 운영하는 Office 365Office 365 operated by 21 Vianet Connect-MsolService -AzureEnvironment AzureChinaCloud
Office 365 GermanyOffice 365 Germany Connect-MsolService -AzureEnvironment AzureGermanyCloud
Office 365 미국 국방부(DoD) 및 Office 365 미국 정부 GCC HighOffice 365 U.S. Government DoD and Office 365 U.S. Government GCC High Connect-MsolService -AzureEnvironment USGovernment

계정에 로그인하세요 대화 상자에서, Microsoft 365 회사 또는 학교 계정 사용자 이름 및 암호를 입력한 다음, 확인 을 선택하세요.In the Sign into your account dialog box, type your Microsoft 365 work or school account user name and password, and then select OK.

다단계 인증을 사용하는 경우 지침에 따라 확인 코드와 같은 추가 인증 정보를 제공합니다.If you're using multi-factor authentication, follow the instructions to provide additional authentication information, such as a verification code.

작동 여부는 어떻게 확인하나요?How do you know it worked?

오류 메시지가 표시되지 않으면 성공적으로 연결된 것입니다.If you don't get an error message, you connected successfully. 빠르게 테스트하려면 Get-MsolUser 과 같은 Microsoft 365 cmdlet을 실행하고 결과를 확인하세요.For quick test, run a Microsoft 365 cmdlet, such as Get-MsolUser , and see the results.

오류 메시지가 표시되는 경우 다음 문제를 확인하세요.If you get an error message, check the following issues:

  • 가장 흔한 문제는 암호를 잘못 입력한 경우입니다.A common problem is an incorrect password. 2단계를 다시 실행하고 사용자 이름과 암호를 입력할 때 신중하게 확인하세요.Run Step 2 again, and pay close attention to the user name and password that you enter.

  • Windows PowerShell용 Microsoft Azure Active Directory 모듈을 사용하려면 컴퓨터에 Microsoft .NET Framework 3.5. x가 있어야 합니다**. 컴퓨터에 최신 버전(예: 4 또는 4.5.* x*)이 설치되어 있을 수 있습니다.The Microsoft Azure Active Directory Module for Windows PowerShell requires that Microsoft .NET Framework 3.5. x is enabled on your computer**. It's likely that your computer has a newer version installed (for example, 4 or 4.5.* x*). 이전 버전의 .NET Framework와 이전 버전과의 호환성을 사용하거나 사용하지 않도록 설정할 수 있습니다.But backward compatibility with older versions of the .NET Framework can be enabled or disabled. 자세한 내용은 다음 문서를 참조하세요.For more information, see the following articles:

  • Windows PowerShell용 Microsoft Azure Active Directory 모듈 버전이 오래되었을 수 있습니다.Your version of the Microsoft Azure Active Directory Module for Windows PowerShell might be out of date. 확인하려면 Windows PowerShell용 Microsoft Azure Active Directory 모듈 또는 Microsoft 365용 PowerShell에서 다음 명령을 실행하세요.To check, run the following command in PowerShell for Microsoft 365 or the Microsoft Azure Active Directory Module for Windows PowerShell:

    (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단계에서 최신 버전을 설치합니다.If the version number returned is lower than 1.0.8070.2 , uninstall the Microsoft Azure Active Directory Module for Windows PowerShell and install from Step 1, above.

  • 연결 오류 메시지가 표시되면 , "Connect-MsolService: 형식 예외가 발생함" 오류를 참조하세요.If you get a connection error message , see "Connect-MsolService: Exception of type was thrown" error.

  • "Get-Item: 경로를 찾을 수 없음" 오류 메시지가 표시되면 , 다음 명령을 실행하세요.If you get a "Get-Item: Cannot find path" error message , run this command:

       (dir "C:\Program Files\WindowsPowerShell\Modules\MSOnline").Name
    

참고 항목See also