SharePoint Server CmdletSharePoint Server Cmdlets

SharePoint Server cmdlet의 목록, SharePoint Server cmdlet 을 참조 하십시오.For a listing of the SharePoint Server cmdlets, see SharePoint Server cmdlets

SharePoint Server용 PowerShell에 액세스Accessing PowerShell for SharePoint Server

SharePoint Server를 설치하고 나면 해당하는 PowerShell cmdlet을 SharePoint 2016 관리 셸에서 사용할 수 있습니다. SharePoint 관리 셸에서는 대부분의 SharePoint Server을 관리할 수 있습니다. 새 사이트 모음, 웹 응용 프로그램, 사용자 계정, 서비스 응용 프로그램, 프록시 등을 만들 수 있습니다. SharePoint 관리 셸에 명령을 입력하면 Microsoft .NET Framework 기반 SharePoint 개체가 반환됩니다. 이러한 개체를 이후 실행하는 명령의 입력으로 적용하거나 나중에 사용하기 위해 로컬 변수에 저장할 수 있습니다.After you install SharePoint Server, applicable PowerShell cmdlets are available in the SharePoint 2016 Management Shell. You can manage most aspects of SharePoint Server in the SharePoint Management Shell. You can create new site collections, web applications, user accounts, service applications, proxies, and more. Commands that you type in the SharePoint Management Shell return SharePoint objects that are based on the Microsoft .NET Framework. You can apply these objects as input to subsequent commands or store the objects in local variables for later use.

SharePoint 관리 셸을 사용 하 여 cmdlet을 포함 하는 스냅인 등록할 필요가 없습니다. SharePoint Server cmdlet에 대 한 Microsoft.SharePoint.PowerShell.dll 모듈의 등록이 자동으로 %CommonProgramFiles%\에 있는 SharePoint.ps1 파일에서 Add-pssnapin Microsoft.SharePoint.PowerShell 줄의 결과 Microsoft Shared\Web Server Extensions<버전 > \Config\PowerShell\Registration, 여기서 버전 "15" SharePoint Server 2013 equals 하 고 "16" 버전에는 SharePoint Server 2016와 같습니다. PowerShell 콘솔을 사용 하려면 등록 해야이 스냅인 수동으로.With the SharePoint Management Shell, you do not have to register the snap-in that contains the cmdlets. Registration of the Microsoft.SharePoint.PowerShell.dll module for SharePoint Server cmdlets is automatic, as a result of the Add-PSSnapin Microsoft.SharePoint.PowerShell line in the SharePoint.ps1 file that is located in %CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration, where version "15" equals SharePoint Server 2013, and version "16" equals SharePoint Server 2016. To use the PowerShell console, you must register this snap-in manually.

SharePoint 관리 셸 또는 PowerShell 콘솔 중 어느 쪽을 사용하든 추가 스냅인을 로드할 수 있습니다. 자세한 내용은 프로필 사용자 지정을 참조하세요.Whether you use the SharePoint Management Shell or the PowerShell console, you can also load additional snap-ins. For more information, see Customizing Profiles.

참고: SharePoint 관리 셸 및 PowerShell 콘솔의 스레딩 모델을 사용 하는 방법을 정의 하는 ReuseThread 옵션을 사용 하 여 다릅니다. SharePoint 관리 셸을 사용 하 여가이 줄에 의해 정의 된 {Host.Runspace.ThreadOptions = "ReuseThread"}, SharePoint.ps1 파일에서은 합니다. 자세한 내용은 PS 스레드 옵션을 참조 하십시오.NOTE: The SharePoint Management Shell and the PowerShell console also differ in the use of the ReuseThread option, which defines how the threading model is used. The SharePoint Management Shell's use is defined by this line, {Host.Runspace.ThreadOptions = "ReuseThread"}, which is in the SharePoint.ps1 file. For more information, see PS Thread Options.

사용 권한Permissions

Add-SPShellAdmin 을 사용하여 SharePoint Server cmdlet 실행 권한을 사용자에게 부여하려면 다음의 최소 요구 사항을 모두 충족하는지 확인하십시오.Before you can use the Add-SPShellAdmin cmdlet to grant permissions for users to run SharePoint Server cmdlets, verify that you meet all of the following minimum requirements:

  • SQL Server 인스턴스에서 securityadmin 고정된 서버 역할의 멤버 자격이 있어야 합니다.You must have membership in the securityadmin fixed server role on the SQL Server instance.
  • PowerShell cmdlet을 실행할 서버의 Administrators 그룹 구성원이어야 합니다.You must be a member of the Administrators group on the server on which you are running the PowerShell cmdlet.

참고: 이러한 사용 권한이 없는 경우, 이러한 사용 권한을 요청 하려면 설치 관리자 또는 SQL Server 관리자에 게 문의 합니다.NOTE: If these permissions are not satisfied, contact your Setup administrator or SQL Server administrator to request these permissions.

PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.For additional information about PowerShell permissions, see Add-SPShellAdmin.

SharePoint_Shell_Access 역할 또는 WSS_Admin_WPG 로컬 그룹의 구성원이 아닌 경우 Add-SPShellAdmin cmdlet을 사용하여 SharePoint_Shell_Access 역할 및 SharePoint 팜의 모든 프런트 엔드 웹 서버에 WSS_Admin_WPG 그룹을 추가합니다. SQL Server 데이터베이스에 SharePoint_Shell_Access 역할이 없으면 Add-SPShellAdmin cmdlet 실행 시 해당 역할이 자동으로 만들어집니다. Add-SPShellAdmin cmdlet을 실행하고 나면 사용자가 다중 서버 팜 환경에서 SharePoint PowerShell cmdlet을 실행할 수 있습니다.If you do not have membership in the SharePoint_Shell_Access role or WSS_Admin_WPG local group, use the Add-SPShellAdmin cmdlet to add the WSS_Admin_WPG group in all front-end web servers in the SharePoint farm and the SharePoint_Shell_Access role. If the SQL Server database does not have a SharePoint_Shell_Access role, the role is automatically created when you run the Add-SPShellAdmin cmdlet. After you run the Add-SPShellAdmin cmdlet, users can run SharePoint PowerShell cmdlets in a multiple-server farm environment.

참고: SharePoint Server를 설치 하면 설치를 실행 하는 사용자 계정에는 PowerShell cmdlet을 실행 하려면 적절 한 권한이 부여 됩니다. PowerShell cmdlet을 실행 하는 사용자가 추가 되지 않은, 하는 경우에 추가할 Add-spshelladmin cmdlet을 사용할 수 있습니다.NOTE: When you install SharePoint Server, the user account from which you run the installation is granted the appropriate permissions to run PowerShell cmdlets. If any users have not been added to run a PowerShell cmdlet, you can use the Add-SPShellAdmin cmdlet to add them.

PowerShell 명령 프롬프트에서 SPShellAdmin cmdlet의 전체 목록을 보려면 입력 Get-command-Noun SPShellAdmin_합니다.To see a list of all of the SPShellAdmin cmdlets, from a PowerShell command prompt, type _Get-Command -Noun SPShellAdmin.

스크립트 및 실행 정책Scripts and execution policies

Microsoft PowerShell을 사용하여 단일 관리 작업을 수행할 수도 있지만, 스크립트를 사용하면 일련의 작업을 자동화할 수 있습니다. 스크립트는 하나 이상의 Microsoft PowerShell 명령을 포함하는 텍스트 파일입니다. Microsoft PowerShell 스크립트의 파일 이름 확장명은 .ps1입니다.Although you can use Microsoft PowerShell to perform a single administrative task, you can also use a script to automate a series of tasks. A script is a text file that contains one or more Microsoft PowerShell commands. Microsoft PowerShell scripts have a .ps1 file name extension.

스크립트를 실행 하려면 최소한 필요한 SharePoint 서버에 대 한 실행 정책은 RemoteSignedPowerShell에 대 한 기본 정책이 하지만 제한 합니다. 정책 제한으로 않으면 SharePoint 관리 셸은 RemoteSigned를 정책을 PowerShell에 대 한 변경 됩니다. 즉, 관리자 권한으로 관리 권한이 있는 SharePoint 관리 셸을 시작 하려면 관리자 권한으로 실행 을 선택 해야 합니다. 이 변경 내용을 모든 PowerShell 세션에 적용 됩니다. 자세한 내용은 ExecutionPolicy 열거형을 참고 하십시오.To run scripts, the minimum required execution policy for SharePoint Server is RemoteSigned, although the default policy for PowerShell is Restricted. If the policy is left as Restricted, the SharePoint Management Shell will change the policy for PowerShell to RemoteSigned. This means that you must select Run as administrator to start the SharePoint Management Shell with elevated administrative permission. This change will apply to all PowerShell sessions. For more information, see ExecutionPolicy Enumeration.

스크립트 및 실행 정책에 대 한 자세한 내용은 about_scriptsabout_execution_policies를 참조 하십시오.For additional information about scripts and execution policies, see about_scripts and about_execution_policies.