Add-SPShellAdmin

Модуль:

sharepoint-server

Применяется к:

SharePoint Server Subscription Edition

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

Синтаксис

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

Описание

При выполнении этого командлета для добавления пользователя к роли 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 для продуктов SharePoint, пользователь должен быть членом роли SharePoint_Shell_Access в базе данных конфигурации и членом локальной группы WSS_ADMIN_WPG на компьютере, на котором установлены продукты SharePoint.

Однако результатом выполнения этого командлета является то, что пользователь, указанный с параметром UserName, будет иметь роль SPDataAccess , если она существует, или db_owner роль, если роль SPDataAccess не существует, в затронутых базах данных, как описано выше. Следовательно, необходимо внимательно продумать, какие пользователи получат такие права доступа.

Следовательно, необходимо внимательно продумать, какие пользователи получат такие права доступа.

Сведения о разрешениях и актуальные сведения о Windows PowerShell для продуктов SharePoint см. в веб-документации по адресу https://go.microsoft.com/fwlink/p/?LinkId=251831.

Примеры

-------------------ПРИМЕР 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 и в указанной базе данных контента, и в базе данных конфигурации посредством передачи имени базы данных в командлет.

Параметры

-AssignmentCollection

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

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

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Database

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

Type:	SPDatabasePipeBind
Position:	Named
Default value:	None
Required:	False
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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

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