Add-SPShellAdmin
Добавляет пользователя к роли SharePoint_Shell_Access для заданной базы данных.
Синтаксис
Default (по умолчанию)
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
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.
Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.
Свойства параметра
| Тип: | SPAssignmentCollection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-database
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает идентификатор GUID базы данных или объект базы данных, содержащей роль SharePoint_Shell_Access, к которой требуется добавить пользователя. Если параметр database не указан, используется база данных конфигурации. База данных конфигурации фермы включается всегда (даже если указана другая база данных).
Свойства параметра
| Тип: | SPDatabasePipeBind |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserName
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Задает имя пользователя, добавляемого к роли SharePoint_Shell_Access в конечной базе данных.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.