피드백

SharePoint Online 관리 셸 시작하기

  • 아티클
  • 읽는 데 4분 걸림

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

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

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

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

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

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

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

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

사용 가능한 모든 cmdlet이 있는지 확인하기 위해 항상 모듈이 최신으로 설정되도록 해야 합니다. 관리 모드에서 SharePoint 실행하여 온라인 관리 셸을 업데이트할 수 있습니다.

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

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

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

  1. 온라인 관리 셸 명령 프롬프트에서 SharePoint 명령을 실행합니다.

    Connect-SPOService -Url https://contoso-admin.sharepoint.com -Credential admin@contoso.com

  2. Windows PowerShell 자격 증명 요청 대화 상자에서 메시지가 표시되면 SharePoint 관리 계정의 암호를 입력합니다.

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

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

  1. 온라인 관리 셸 명령 프롬프트에서 SharePoint 명령을 실행합니다.

    Connect-SPOService -Url https://contoso-admin.sharepoint.com

  2. Microsoft SharePoint Online 관리 셸 대화 상자에서 메시지가 표시되면 SharePoint 관리자 계정의 계정 이름과 암호를 입력하고 로그인 을 클릭합니다.

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

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

참고

  • MFA를 사용하여 연결하려고 할 때 문제가 발생하는 경우 온라인 관리 셸에서 Connect-SPOService 최신 인증을 강제로 SharePoint 참조하세요.

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