Командлеты SharePoint Server

Список командлетов SharePoint Server см. в статье Командлеты SharePoint Server.

Доступ к PowerShell для SharePoint Server

После установки SharePoint Server применимые командлеты PowerShell будут доступны в командной консоли SharePoint 2016. Управлять большинством компонентов SharePoint Server можно в командной консоли SharePoint. С ее помощью можно создавать новые семейства веб-сайтов, веб-приложения, учетные записи пользователей, приложения-службы, прокси и многое другое. Вводимые в командную консоль SharePoint команды возвращают объекты SharePoint на основе платформы Microsoft .NET Framework. Эти объекты можно использовать в последующих командах или сохранять в локальных переменных для дальнейшего использования.

При использовании командной консоли SharePoint не требуется регистрировать оснастку, содержащую командлеты. Регистрация модуля Microsoft.SharePoint.PowerShell.dll для командлетов SharePoint Server осуществляется автоматически в результате выполнения строки Add-PSSnapin Microsoft.SharePoint.PowerShell в файле SharePoint.ps1, расположенном в папке %CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration, где версия "15" соответствует SharePoint Server 2013, а версия "16" соответствует SharePoint Server 2016. Если вы предпочитаете использовать консоль PowerShell, эту оснастку необходимо зарегистрировать вручную.

При использовании командной консоли SharePoint или консоли PowerShell также можно загружать дополнительные оснастки.

Примечание

Командная консоль SharePoint и консоль PowerShell отличаются использованием параметра ReuseThread, который определяет использование потоковой модели. Использование командной консоли SharePoint определяется строкой {Host.Runspace.ThreadOptions = "ReuseThread"} в файле SharePoint.ps1. Дополнительные сведения см. в разделе Параметры потока PS.

Разрешения

Прежде чем использовать командлет Add-SPShellAdmin, чтобы предоставить пользователям разрешения на выполнение командлетов SharePoint Server, убедитесь, что соблюдены следующие минимальные требования:

  • Вы должны быть участником предопределенной роли сервера securityadmin в экземпляре SQL Server.
  • Вы должны входить в группу "Администраторы" сервера, на котором выполняется командлет PowerShell.

Примечание

Если этих разрешений недостаточно, обратитесь к администратору установки или администратору SQL Server за дополнительными разрешениями.

Дополнительные сведения о разрешениях PowerShell см. в статье Add-SPShellAdmin.

Если вы не являетесь участником роли SharePoint_Shell_Access или локальной группы WSS_Admin_WPG, используйте командлет Add-SPShellAdmin для добавления группы WSS_Admin_WPG на все интерфейсные веб-серверы в ферме SharePoint и в роль SharePoint_Shell_Access. Если в базе данных SQL Server отсутствует роль SharePoint_Shell_Access, она автоматически создается при выполнении командлета Add-SPShellAdmin. После выполнения командлета Add-SPShellAdmin пользователи могут выполнять командлеты SharePoint PowerShell в среде фермы с несколькими серверами.

Примечание

Учетной записи пользователя, под которой выполнялась установка SharePoint Server, предоставляются соответствующие разрешения на выполнение командлетов PowerShell. Если вам требуется предоставить разрешения на выполнение командлетов PowerShell другим пользователям, используйте для этого командлет Add-SPShellAdmin.

Чтобы просмотреть список всех командлетов SPShellAdmin, введите Get-Command -Noun SPShellAdmin в командной строке PowerShell.

Скрипты и политики выполнения

С помощью Microsoft PowerShell вы можете выполнять как отдельные задачи по администрированию, так и последовательности задач, которые автоматизируются с помощью скриптов. Скрипт представляет собой текстовый файл с одной или несколькими командами Microsoft PowerShell. Файлы скриптов Microsoft PowerShell имеют расширение ps1.

Для выполнения скриптов требуется минимальный уровень политики выполнения RemoteSigned для SharePoint Server, хотя по умолчанию для PowerShell установлена политика Restricted. Если оставить политику RemoteSigned, командная консоль SharePoint изменит политику для PowerShell на RemoteSigned. Это означает, что необходимо выбрать команду Запуск от имени администратора, чтобы запустить командную консоль SharePoint с повышенными административными разрешениями. Это изменение будет применено ко всем сеансам PowerShell. Дополнительные сведения см. в статье Перечисление ExecutionPolicy.

Дополнительные сведения о скриптах и политиках выполнения см. в статьях О скриптах и Сведения о политиках выполнения.