Обзор модуля Microsoft.SharePoint.Powershell

Список командлетов SharePoint Server см. в разделе Командлеты Microsoft.SharePoint.Powershell.

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

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

С помощью командной консоли SharePoint вам не нужно регистрировать оснастку, содержащую командлеты. Регистрация обрабатывается строкой Add-PSSnapin Microsoft.SharePoint.PowerShell в SharePoint.ps1 файле. Этот файл находится в %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration папке.

• <version> 15 равно SharePoint Server 2013
• и <version> 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 , в командной строке PowerShell введите Get-Command -Noun SPShellAdmin.

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

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

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