SharePoint Online 관리 셸 시작하기

PowerShell을 사용하여 SharePoint Online을 관리하려면 SharePoint Online 관리 셸을 설치하고 SharePoint Online에 연결해야 합니다.

SharePoint Online 관리 셸을 다운로드하고 실행하거나 PowerShell Gallery의 모듈을 설치하여 SharePoint Online 관리 셸을 설치하세요. 설치한 후에는 모듈을 사용할 수 있으며, 이후 버전에 도입된 기능이 필요할 때까지 다시 설치할 필요가 없습니다. 예를 들어 2018년 10월 이후에 TLS 1.2 협상을 위해 새 버전을 설치해야 할 수 있습니다.

먼저 PowerShell에서 관리 모드에서 다음 명령을 실행하여 SharePoint Online 관리 셸을 이미 설치했는지 확인할 수 있습니다.

Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable | Select Name,Version

운영 체제에서 PowerShell 5 이상을 사용하는 경우 관리 모드에서 다음 명령을 실행하여 SharePoint Online 관리 셸을 설치할 수도 있습니다.

Install-Module -Name Microsoft.Online.SharePoint.PowerShell

시스템에 대한 관리 권한이 없는 경우 다음 명령을 실행하여 현재 사용자에 대해서만 SharePoint Online 관리 셸을 설치할 수 있습니다.

Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser

사용 가능한 cmdlet이 모두 있는지 확인하려면 항상 모듈이 최신 상태인지 확인해야 합니다. 관리 모드에서 다음 명령을 실행하여 SharePoint Online 관리 셸을 업데이트할 수 있습니다.

Update-Module -Name Microsoft.Online.SharePoint.PowerShell

시작 화면에서 SharePoint Online 관리 셸 명령 프롬프트를 열려면 sharepoint 를 입력한 다음 SharePoint Online 관리 셸 을 클릭합니다.

사용자 이름 및 암호를 사용하여 연결하려면

  1. SharePoint Online 관리 셸 명령 프롬프트에서 다음 명령을 실행합니다.

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com
    
  2. Windows PowerShell 자격 증명 요청 대화 상자에서 메시지가 표시되면 SharePoint 관리 계정의 암호를 입력합니다.

사용자에게 SharePoint 관리자 역할을 할당하려면 관리자 역할 할당 또는 PowerShell을 사용하여 Microsoft 365 사용자 계정에 관리자 역할 할당을 참조하세요.

참고

'오류 메시지: SharePoint Online에 연결할 수 없습니다.'와 같은 오류가 발생하거나 연결하려고 하면 최신 인증을 사용해야 할 수 있습니다. 다음 예를 참조하십시오.

Connect-SPOService -Credential $creds -Url https://tenant-admin.sharepoint.com -ModernAuth $true -AuthenticationUrl https://login.microsoftonline.com/organizations

MFA(다단계 인증)를 사용하여 연결하려면

  1. SharePoint Online 관리 셸 명령 프롬프트에서 다음 명령을 실행합니다.

    Connect-SPOService -Url https://contoso-admin.sharepoint.com
    
  2. Microsoft SharePoint Online 관리 셸 대화 상자에서 메시지가 표시되면 SharePoint 관리자 계정의 계정 이름과 암호를 입력하고 로그인 을 클릭합니다.

  3. Microsoft SharePoint Online 관리 셸 대화 상자의 지침에 따라 인증 코드와 같은 추가 인증 정보를 제공한 다음 로그인 을 클릭합니다.

이제 SharePoint Online 명령을 사용할 준비가 되었습니다.

참고

SharePoint Online 관리 셸 모듈과 SharePoint 클라이언트 구성 요소 SDK 간에 알려진 문제가 있습니다. 두 모듈이 모두 동일한 컴퓨터에 설치된 경우 모듈이 로드되지 않습니다. 이 문제가 발생하면 SharePoint 클라이언트 구성 요소 SDK를 제거합니다.