Add-SPShellAdmin

지정된 데이터베이스에 대한 SharePoint_Shell_Access 역할에 사용자를 추가합니다.

Syntax

Add-SPShellAdmin
   [-UserName] <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Database <SPDatabasePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

이 cmdlet을 실행하여 사용자를 SharePoint_Shell_Access 역할에 추가하는 경우 SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할 구성원 자격, 영향을 받는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할 구성원 자격, 그리고 로컬 컴퓨터에 대한 로컬 관리 권한이 있어야 합니다.

This cmdlet is intended only to be used with a database that uses Windows authentication. There is no need to use this cmdlet for databases that use SQL authentication; in fact, doing so may result in an error message.

Add-SPShellAdmin cmdlet을 사용하여 다음과 같이 SharePoint_Shell_Access 역할에 사용자를 추가합니다.

--사용자를 한 명만 지정하면 해당 사용자가 팜 구성 데이터베이스에 대한 역할에 추가됩니다.

--If you use the database parameter, the user is added to the role on the farm configuration database, the Central Administration content database, and the specified database. Using the database parameter is the preferred method because most of the administrative operations require access to the Central Administration content database.

The user is added to the WSS_Admin_WPG group on all Web servers when the user is added to the SharePoint_Shell_Access role. If the target database does not have a SharePoint_Shell_Access role, the role is automatically created.

SharePoint 제품에 Windows PowerShell 사용하려면 사용자가 구성 데이터베이스에서 SharePoint_Shell_Access 역할의 멤버이고 SharePoint 제품이 설치된 컴퓨터에서 WSS_ADMIN_WPG 로컬 그룹의 구성원이어야 합니다.

그러나 이 cmdlet을 실행한 결과 UserName 매개 변수로 지정된 사용자에게 는 SPDataAccess 역할이 있는 경우 SPDataAccess 역할이 있거나, 위에서 설명한 대로 영향을 받는 데이터베이스에 SPDataAccess 역할이 없는 경우 역할을 db_owner. 따라서 이 액세스 권한을 부여할 사용자를 계획할 때에는 주의해야 합니다.

따라서 이 액세스 권한을 부여할 사용자를 계획할 때에는 주의해야 합니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 온라인 설명서(https://go.microsoft.com/fwlink/p/?LinkId=251831)를 참고하세요.

예제

---------------예제 1---------------

Add-SPShellAdmin -UserName CONTOSO\User1

이 예제에서는 팜 구성 데이터베이스에 있는 SharePoint_Shell_Access 역할에만 이름이 User1인 새 사용자를 추가하며 사용자는 팜의 각 서버에 있는 WSS_Admin_WPG 로컬 그룹에 추가됩니다.

---------------예제 2---------------

Add-SPShellAdmin -UserName CONTOSO\User1 -database 4251d855-3c15-4501-8dd1-98f960359fa6

이 예제에서는 데이터베이스 GUID를 cmdlet에 전달하여 지정한 콘텐츠 데이터베이스 및 구성 데이터베이스 모두의 SharePoint_Shell_Access 역할에 이름이 User1인 새 사용자를 추가합니다.

-------------------예제 3-------------------------

Get-SPDatabase | Where-Object {$_.WebApplication -like "SPAdministrationWebApplication"} | Add-SPShellAdmin CONTOSO\User1

이 예제에서는 지정한 중앙 관리 콘텐츠 데이터베이스와 구성 데이터베이스 모두의 SharePoint_Shell_Access 역할에 이름이 User1인 새 사용자를 추가합니다.

-------------------예제 4-------------------------

Get-SPDatabase | ?{$_.Name -eq "WSS_Content"} | Add-SPShellAdmin -Username CONTOSO\User1

이 예제에서는 데이터베이스 이름을 cmdlet에 전달하여 지정한 콘텐츠 데이터베이스 및 구성 데이터베이스 모두의 SharePoint_Shell_Access 역할에 이름이 User1인 새 사용자를 추가합니다.

매개 변수

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

명령을 실행하기 전에 사용자에게 확인 메시지를 표시합니다. 자세한 내용을 확인하려면 다음 명령을 입력하세요. get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Database

Specifies the GUID of the database or the Database object that includes the SharePoint_Shell_Access role to which you want to add the user. If the database parameter is not specified, the configuration database is used. The farm configuration database is always included, even if you specify another database.

Type:SPDatabasePipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-UserName

대상 데이터베이스의 SharePoint_Shell_Access 역할에 추가할 사용자의 이름을 지정합니다.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition