Add-SPShellAdmin

 

Применимо к:SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

Последнее изменение раздела:2015-03-09

Добавляет пользователя к роли SharePoint_Shell_Access для заданной базы данных.

Add-SPShellAdmin [-UserName] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-database <SPDatabasePipeBind>] [-WhatIf [<SwitchParameter>]]

ВажноВажно!
При выполнении этого командлета для добавления пользователя к роли SharePoint_Shell_Access вы должны быть членом предопределенной роли сервера securityadmin в экземпляре SQL Server, предопределенной роли базы данных db_owner на всех затрагиваемых базах данных и должны обладать правами локального администратора на локальном компьютере.
Этот командлет предназначен для применения только с базой данных, использующей проверку подлинности Windows. Его не нужно применять для базы данных, использующей проверку подлинности SQL. К слову, это может привести к появлению сообщения об ошибке.

Используйте командлет Add-SPShellAdmin для добавления пользователя к роли SharePoint_Shell_Access следующим образом:

--Если указан только пользователь, этот пользователь будет добавлен к роли для базы данных конфигурации фермы.

--При использовании параметра database пользователь добавляется к роли в базе данных конфигурации фермы, базе данных содержимого центра администрирования и в указанной базе данных. Предпочтительно использовать именно параметр database, так как для большинства операций администрирования требуется доступ к базе данных содержимого центра администрирования.

При добавлении пользователя к роли SharePoint_Shell_Access он также добавляется в группу WSS_Admin_WPG на всех веб-серверах. Если в конечной базе данных отсутствует роль SharePoint_Shell_Access, она будет создана автоматически.

ВажноВажно!
Чтобы использовать Windows PowerShell 3.0 для продуктов SharePoint 2013 пользователь должен быть участником роли SharePoint_Shell_Access в базе данных конфигурации и участником локальной группы WSS_ADMIN_WPG на компьютере, на котором установлены продукты SharePoint 2013. Однако результаты выполнения этого командлета заключаются в том, что пользователь, указавший параметр UserName, получит права доступа роли dbo_owner для затронутых баз данных, как описано выше. Следовательно, необходимо внимательно продумать, какие пользователи получат такие права доступа.

Командная консоль SharePoint

 

Параметр Обязательный? Тип Описание

UserName

Обязательный

System.String

Задает имя пользователя, добавляемого к роли SharePoint_Shell_Access в конечной базе данных.

AssignmentCollection

Необязательный

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

ПримечаниеПримечание
Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Предлагает подтвердить выполнение команды. Для получения дополнительных сведений введите такую команду: get-help about_commonparameters

database

Необязательный

Microsoft.SharePoint.PowerShell.SPDatabasePipeBind

Задает идентификатор GUID базы данных или объект базы данных, содержащей роль SharePoint_Shell_Access, к которой требуется добавить пользователя. Если параметр database не указан, используется база данных конфигурации. База данных конфигурации фермы включается всегда (даже если указана другая база данных).

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Вместо выполнения команды выводит ее описание. Для получения дополнительных сведений введите такую команду: get-help about_commonparameters

-------------------ПРИМЕР 1-------------------------

Add-SPShellAdmin -UserName CONTOSO\User1

В этом примере новый пользователь User1 добавляется к роли SharePoint_Shell_Access только в базе данных конфигурации фермы; кроме того, этот пользователь добавляется в локальную группу WSS_Admin_WPG на каждом сервере фермы.

-------------------ПРИМЕР 2-------------------------

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

В этом примере новый пользователь с именем User1 добавляется к роли SharePoint_Shell_Access и в указанной базе данных контента, и в базе данных конфигурации посредством передачи идентификатора GUID базы данных в командлет.

-------------------ПРИМЕР 3-------------------------

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

В этом примере новый пользователь с именем User1 добавляется к роли SharePoint_Shell_Access и в указанной базе данных контента центра администрирования, и в базе данных конфигурации.

-------------------ПРИМЕР 4-------------------------

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

В этом примере новый пользователь с именем User1 добавляется к роли SharePoint_Shell_Access и в указанной базе данных контента, и в базе данных конфигурации посредством передачи имени базы данных в командлет.

Показ: