Управление службами Excel с помощью Windows PowerShell

  • Статья

 

Применимо к: Excel Services (SharePoint 2010), SharePoint Server 2010

Последнее изменение раздела: 2010-07-26

В этом разделе приведен высокоуровневый обзор поведения Windows PowerShell для администраторов служб Excel в Microsoft SharePoint Server 2010. Администраторы служб Службы Excel могут использовать Windows PowerShell для написания скриптов, полностью автоматизирующих установку и развертывание служб Службы Excel, параметры конфигурации и настройку всех параметров во время выполнения в рамках развертывания Microsoft SharePoint Server 2010. В Windows PowerShell в службах Службы Excel используются те же соглашения об именовании, стиле и рекомендации по поведению, что и для других приложений-служб. В SharePoint Server реализована командная строка Windows PowerShell, обеспечивающая выполнение административных действий для служб Службы Excel.

Windows PowerShell для служб Excel

Для выполнения любых команд Windows PowerShell (командлеты) пользователь должен быть членом роли глобального администратора, а также локальным администратором компьютера. Обычно все командлеты Windows PowerShell управляют объектами в памяти. Командлеты Set записывают значения свойств в хранилище данных configdb для службы.

Предупреждение

В службах Службы Excel команда stsadm не поддерживается. Использование любой команды stsadm завершается сбоем и отображением сообщения об ошибке в командной строке.

Все командлеты служб Службы Excel, Windows PowerShell поддерживают общие команды Windows PowerShell. Администраторы могут разделять команды символом вертикальной черты, просматривать справку по каждой команде, использовать псевдонимы команд, фильтровать результаты, разрешать использование параметра whatif, подтверждать, а также использовать в командах переменные и параметры. Дополнительные сведения о командах Windows PowerShell см. в статье Командлеты служб Excel (SharePoint Server 2010).

Примеры командлетов для служб Excel

В этом разделе описывается порядок открытия командной консоли SharePoint 2010 для выполнения примеров командлетов служб Службы Excel для служб Службы Excel.

Открытие командной консоли SharePoint 2010

  1. Убедитесь в соответствии следующим минимальным требованиям: См. статью Add-SPShellAdmin.

  2. В меню Пуск выберите пункт Все программы.

  3. Выберите пункт Продукты Microsoft SharePoint 2010.

  4. Щелкните компонент Командная консоль SharePoint 2010.

  5. В командной строке Windows PowerShell (PS C:\>) введите следующие примеры команды и нажмите клавишу ВВОД:

  • Подготовка нового приложения Приложение служб Excel с именем "MyExcelServer"
    New-SPExcelServiceApplication -Name "MyExcelServer"

  • Установка максимального числа сеансов для каждого пользователя равным 100 для всех удаленных компьютеров в ферме, на которых выполняется экземпляр служб Службы Excel:
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -SessionsPerUserMax 100

  • Получение всех надежных расположений для MyExcelServer. Для всех надежных расположений, позволяющих загружать данные из рабочих книг, определение принудительного использования только библиотеки подключений к документам (DCL)
    Get-SPExcelServiceApplication -Identity "MyExcelServer" | Get-SPExcelFileLocation | where {$_.ExternalDataAllowed -eq "DclAndEmbedded" } | Set-SPExcelFileLocation -ExternalDataAllowed Dcl

  • Предоставление доступа к рабочим книгам в надежных расположениях (и подключениям к данным в надежных библиотеках подключений к данным) между доменами для веб-частей, веб-страниц или веб-служб с помощью командлета Windows PowerShell. Следующие примеры команды работают для всех приложений-служб Excel в ферме SharePoint Server:
    Присвоение значения true:
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed
    Присвоение значения false:
    Get-SPExcelServiceApplication | Set-SPExcelServiceApplication -CrossDomainAccessAllowed:$false
    Проверка:
    (Get-SPExcelServiceApplication).CrossDomainAccessAllowed