PowerShell Office 365에 연결Connect to Office 365 PowerShell

요약: Office 365 PowerShell을 통해 Office 365 조직에 연결하여 명령줄에서 관리 작업을 수행합니다.Summary: Connect to your Office 365 organization using Office 365 PowerShell to perform Office 365 administration tasks from the command line.

Office 365 PowerShell을 사용하여 명령줄에서 Office 365 설정을 관리할 수 있습니다.Office 365 PowerShell lets you to manage your Office 365 admin center settings from the command line. Office 365 PowerShell에 연결하려면 필요한 소프트웨어를 설치하고 Office 365 조직에 연결하는 간단한 과정을 수행합니다.Connecting to Office 365 PowerShell is a simple three-step process where you install the required software, run the required software, and then connect to your Office 365 organization.

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

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

이 문서의 날짜를 기준으로, Azure Active Directory PowerShell for Graph 모듈이 사용자, 그룹 및 라이선스 관리를 위해 Windows PowerShell용 Microsoft Azure Active Directory 모듈을 완전히 대체하는 것은 아닙니다.As of the date of this article, the Azure Active Directory PowerShell for Graph module does not completely replace the functionality in the cmdlets of Microsoft Azure Active Directory Module for Windows PowerShell module for user, group, and license administration. 대부분의 경우, 두 버전을 사용해야 합니다.In many cases, you need to use both versions. 동일한 컴퓨터에 두 버전을 안전하게 설치할 수 있습니다.You can safely install both versions on the same computer.

PowerShell을 처음 사용하시나요? PowerShell의 비디오 개요를 보고 LinkedIn Learning을 통해 가져올 수 있습니다.New to PowerShell? See a video Overview of PowerShell, brought to you by LinkedIn Learning.

시작하기 전에 알아야 할 내용What do you need to know before you begin?

  • 예상 완료 시간: 5분Estimated time to complete: 5 minutes

  • 다음 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 2016, Windows Server 2012 R2, Windows Server 2012, or Windows Server 2008 R2 SP1

      참고

      Windows 64비트 버전을 사용하세요. 32비트 버전의 Microsoft PowerShell용 Windows Azure Active Directory 모듈은 2014년 10월에 중단되었습니다.Use a 64-bit version of Windows. Support for the 32-bit version the Microsoft Azure Active Directory Module for Windows PowerShell was discontinued in October of 2014.

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

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

Azure Active Directory PowerShell for Graph 모듈의 명령에는 cmdlet 이름에 AzureAD가 있습니다.Commands in the Azure Active Directory V2 PowerShell module have "AzureAD" in their cmdlet name.

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

참고

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

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

다음이 단계 연결할 때마다 하지 컴퓨터에 한 번만 필요 합니다. 주기적으로 최신 버전의 소프트웨어를 설치 하려면 필요할 수 있습니다.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  1. 관리자 권한의 Windows PowerShell 명령 프롬프트를 엽니다(관리자 권한으로 Windows PowerShell 실행).Open an elevated Windows PowerShell command prompt (run Windows PowerShell as an administrator).

  2. ** 관리자에서 Windows PowerShell** 명령 창에서 다음 명령을 실행합니다.In the Administrator: Windows PowerShell command window, run this command:

Install-Module -Name AzureAD

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

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

계정 이름 및 암호를 사용하여 또는 MFA(다중 요소 인증) 을 사용하여 Office 365 구독을 위해 Azure AD에 연결하려면, Windows PowerShell 명령 프롬프트(관리자 권한이 아니어도 됨)에서 이 명령 중 하나를 실행하세요.To connect to Azure AD for your Office 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not 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

계정에 로그인하세요 대화 상자에서, Office 365 회사 또는 학교 계정 사용자 이름 및 암호를 입력한 다음, 확인을 클릭하세요.In the Windows PowerShell Credential Request dialog box, type your Office 365 work or school account user name and password, and then click OK.

MFA를 사용하는 경우, 추가 대화 상자에 있는 지침을 따라서 추가 인증 정보(예: 확인 코드)를 제공하세요.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

연결이 되면 zure Active Directory PowerShell for Graph 모듈의 새 cmdlet을 사용할 수 있습니다.After connecting, you can use the new cmdlets for the Azure Active Directory V2 PowerShell 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 이름에 Msol이 있습니다.Commands in the Microsoft Azure Active Directory Module for Windows PowerShell have Msol in their cmdlet name.

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

다음이 단계 연결할 때마다 하지 컴퓨터에 한 번만 필요 합니다. 주기적으로 최신 버전의 소프트웨어를 설치 하려면 필요할 수 있습니다.These steps are required once on your computer, not every time you connect. However, you'll likely need to install newer versions of the software periodically.

  1. 64비트 버전의 Microsoft Online Services 로그인 도우미를 설치합니다.IT 전문가용 Microsoft Online Services 로그인 도우미 RTW를 설치합니다.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 모듈을 설치합니다.Install the Microsoft Azure Active Directory Module for Windows PowerShell with these steps:

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

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

계정 이름 및 암호를 사용하여 또는 MFA(다중 요소 인증) 을 사용하여 Office 365 구독을 위해 Azure AD에 연결하려면, Windows PowerShell 명령 프롬프트(관리자 권한이 아니어도 됨)에서 이 명령 중 하나를 실행하세요.To connect to Azure AD for your Office 365 subscription with an account name and password or with multi-factor authentication (MFA), run one of these commands from a Windows PowerShell command prompt (it does not 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

계정에 로그인하세요 대화 상자에서, Office 365 회사 또는 학교 계정 사용자 이름 및 암호를 입력한 다음, 확인을 클릭하세요.In the Windows PowerShell Credential Request dialog box, type your Office 365 work or school account user name and password, and then click OK.

MFA를 사용하는 경우, 추가 대화 상자에 있는 지침을 따라서 추가 인증 정보(예: 확인 코드)를 제공하세요.If you are using MFA, follow the instructions in the additional dialog boxes to provide more authentication information, such as a verification code.

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

어떠한 오류도 전송되지 않으면 성공적으로 연결되었음을 의미합니다. 빠른 테스트는 Office 365 cmdlet(예: Get-MsolUser )을 실행하여 결과를 확인하는 것입니다.If you don't receive any errors, you connected successfully. A quick test is to run an Office 365 cmdlet—for example, Get-MsolUser —and see the results.

오류가 발생하면 다음 요구 사항을 확인합니다.If you receive errors, check the following requirements:

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

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

  • 사용자의 Microsoft PowerShell용 Windows Azure Active Directory 모듈 버전이 오래되었을 수 있습니다. 확인하려면 Microsoft PowerShell용 Windows Azure Active Directory 모듈 또는 Office 365 PowerShell에서 다음 명령을 실행하세요.Your version of the Microsoft Azure Active Directory Module for Windows PowerShell might be out of date. To check, run the following command in Office 365 PowerShell 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 값보다 낮은 경우 Microsoft PowerShell용 Windows Azure Active Directory 모듈을 제거한 후 1단계의 링크에서 최신 버전을 설치합니다.If the version number returned is lower than the value 1.0.8070.2, uninstall the Microsoft Azure Active Directory Module for Windows PowerShell and install the latest version from the link in Step 1.

  • 연결 오류가 발생하면 "Connect-MsolService: 형식의 예외가 발생했습니다." 오류 항목을 참조하세요.If you receive a connection error, see this topic: "Connect-MsolService: Exception of type was thrown" error.

참고 항목See also