Поделиться через

Мастер действий командной строки

  • Статья

Мастер действий командной строки позволяет быстро создавать новые действия в Orchestrator путем инкапсулирования команд, аргументов и параметров в сборку Microsoft .NET (.DLL). Мастер автоматически создает исходный код C# с помощью пакета SDK Orchestrator и компилирует его для вас. С помощью этой сборки можно использовать пакет интеграции .NET (часть набора средств интеграции) для тестирования действий, а затем использовать мастер пакетов интеграции для упаковки сборки в пользовательский пакет интеграции, который может быть распределен и развернут так же, как и другие пакеты интеграции.

Сборка может содержать одну или несколько действий (команд), а действия могут быть одним или несколькими доступными типами команд (команда, командная строка, PowerShell или команда SSH). Вы определяете имя действия, структуру команд, входные параметры и даже опубликованные данные (выходные данные).

Обзор действий в Orchestrator

Действие является одной функциональной частью runbook Orchestrator. Действия — это то, что делает фактическую работу в модулях Runbook и объединяется с помощью ссылок, которые можно определить с условиями для создания ветвей рабочих процессов. При создании модуля Runbook с помощью конструктора Runbook вы перетаскиваете действия из области действий в модуль Runbook и связываете их вместе, чтобы сформировать рабочий процесс. При выполнении модуля Runbook вызывает каждое действие в последовательности в соответствии с тем, как они были связаны. Каждое действие выполняет определенную обязанность и может собирать входные данные из шины данных Orchestrator и публиковать выходные данные в той же шине данных. Каждое действие имеет возможность извлекать опубликованные данные из любого из действий, выполняемых до него в runbook, и публикация выходных данных позволяет следующим действиям получить к нему доступ.

Действия варьируются от простого до сложного. Вы можете создать действие с помощью мастера действий командной строки, который ничего не делает, кроме эхо текста в выходном свойстве. Вы также можете создать одно действие, которое выполняет сложное многофакторное действие, например развертывание виртуальной машины. Это до вас, чтобы определить, что будет делать каждое действие. Однако ваша цель состоит в определении действий, которые инкапсулируют отдельные наборы функций, которые позволяют легко использовать повторно в различных типах ситуаций. Ключом является гибкость. Лучше создать набор из 10 различных действий, которые выполняют определенные действия и смогут использовать эти действия 20 разными способами, а не создавать 20 различных действий для решения конкретных отдельных сценариев. Дополнительные сведения о рекомендациях см. далее в этом документе.

Создание сборки действия

Выполните следующие действия, чтобы создать новую сборку действия командной строки:

  1. Мастер запуска > всех программ > Microsoft System Center 2012 > Orchestrator Integration Toolkit > Orchestrator >

  2. Выберите Далее.

  3. На странице сведений о сборке введите значение имени, которое начинается с буквы и за которым следует нулевая или более буквенно-цифровых символов. Это имя используется в качестве идентификатора пространства имен C# для сборки и действий.

  4. В файле сборки введите путь и имя файла сборки, который будет создан этим мастером. Если этот файл уже существует, вам будет предложено перезаписать файл.

  5. Выберите сведения о сборке. Здесь можно ввести сведения, которые станут свойствами файла сборки, видимыми в проводнике Windows с помощью свойств файла. Значения свойств определяются в таблице ниже. Эта информация необязательна и не требуется для сборки сборки.

    Свойство Описание
    Должность Задает заголовок сборки, которая отображается как свойство описания файла в свойствах проводника Windows
    Description Указывает необязательное описание сборки, которая не отображается в свойствах проводника Windows
    Продукт Указывает имя продукта для сборки, которое отображается как свойство "Имя продукта" в свойствах проводника Windows
    Company Указывает имя компании для сборки, которая не отображается в свойствах проводника Windows
    Авторские права Указывает уведомление об авторских правах для сборки, которая отображается как авторские права в свойствах Проводника Windows
    Товарный знак Указывает товарный знак сборки, который отображается как юридические товарные знаки в свойствах проводника Windows
    Версия Указывает версию сборки и версию файла. Они отображаются в свойствах проводника Windows в качестве версии файла и версии продукта.

    Номер версии состоит из четырех частей:

    <основная версия>.<дополнительная версия>.<номер сборки>.<пересмотр>

  6. Нажмите кнопку "ОК ", когда вы закончите ввод сведений о сборке.

  7. Выберите Далее. Откроется страница "Команды ".

  8. Добавьте одну или несколько команд, следуя инструкциям, приведенным в разделе "Добавление команд" в сборку.

  9. После завершения определения действия нажмите кнопку "ОК". Диалоговое окно закрывается, и новое действие добавляется в список на странице "Команды ". Если вам нужно вернуться и изменить команду, выберите команду в списке и нажмите кнопку "Изменить". Если вам нужно удалить команду, выберите команду в списке и нажмите кнопку "Удалить".

  10. После завершения добавления и изменения команд нажмите кнопку "Далее". Файл сборки, указанный в начале мастера, компилируется, и после завершения процесса отображается окончательная страница мастера.

  11. Если вы хотите немедленно создать пакет интеграции из этой новой сборки, нажмите кнопку "Сборка пакета интеграции", которая запускает мастер пакета интеграции и предварительно загружает сведения из сборки. Затем следуйте инструкциям в разделе "Создание нового пакета интеграции", чтобы создать пакет интеграции.

  12. Если вы хотите протестировать сборку с помощью действия Invoke .NET или просто пропустить процесс сборки IP-адресов, нажмите кнопку "Готово".

Добавление команд в сборку

Выполните следующие действия, чтобы добавить команду в сборку:

  1. На странице "Команды" можно определить одну или несколько команд (которые становятся действиями), которые будут добавлены в сборку. Чтобы добавить новую команду, нажмите кнопку "Добавить".

  2. В диалоговом окне "Команда добавления и редактирования" отображаются три вкладки: общие, аргументы и опубликованные данные. Введите Имя команды. Это становится именем, отображаемым в конструкторе Runbook для действия. Кроме того, можно ввести описание команды.

  3. Селектор свойств Mode содержит четыре параметра: выполнить команду, запустить Windows PowerShell, запустить программу и выполнить команду SSH. Если выбран режим запуска программы , поле "Программа " становится активным. Нажмите кнопку с многоточием (...) и найдите программу, которую вы хотите запустить.

    Примечание.

    Программа, выбранная в команде run Program, будет вызвана на сервере Runbook, где выполняется модуль Runbook, содержащий это действие. Поэтому эта программа должна существовать на всех серверах Runbook, где ожидается запустить модуль Runbook.

  4. Выберите вкладку "Аргументы".

  5. В поле командной строки введите параметры командной строки или командной строки, необходимые для действия. Если команда примет параметры, которые нужно указать пользователям, необходимо добавить их в список параметров ниже, а затем нажмите кнопку "Вставить", чтобы добавить их в командную строку.

    Внимание

    Если вы указали windows PowerShell для режима и ссылаетесь на скрипт PowerShell, включенный в пакет интеграции, необходимо предшествуть имени скрипта с символами точки и косой черты, чтобы ссылаться на локальный каталог. Например, .\MyScript.ps1 будет указан для скрипта с именем MyScript.ps1. Это связано с тем, что файл скрипта будет скопирован в каталог по умолчанию для пакета интеграции. Если Windows PowerShell запускает скрипт из локального каталога, он должен указать эту нотацию.

  6. Чтобы указать параметры для командной строки, нажмите кнопку "Добавить". Откроется диалоговое окно "Добавить и изменить параметр ".

  7. В поле "Имя" введите имя добавляемого параметра. Это отображаемое имя параметра, показанного в списке свойств действия.

  8. В раскрывающемся списке "Режим использования" выберите режим, который будет использоваться для параметра. Режим использования имеет два варианта:

    Режим использования Description
    Аргумент команды Выберите этот аргумент в качестве параметра в командной строке (с помощью кнопки "Вставить "). Например, параметр аргумента команды с именем "Папка" можно поместить в командную строку следующим образом:

    Dir $(folder)Заметка: Если аргументы командной строки содержат пробелы (например, имена папок), может потребоваться заключить их в кавычки, чтобы команда работала правильно. Например: Dir "$(folder)"
    Переменная среды Выберите этот аргумент в качестве переменной среды, которая будет задана перед запуском командной строки. Его можно использовать в качестве параметра командной строки или в качестве переменной среды в скрипте, который выполняется.

    Например, параметр переменной среды с именем Folder можно поместить в командную строку следующим образом:

    Dir %Folder%Важный: Имя переменной среды уже существует в пользовательских или системных средах; Команда завершится ошибкой с сообщением об ошибке, аналогичному следующему: элемент уже добавлен. Ключ в словаре: "папка", добавляемый ключ: "папка". Вы можете определить, какие переменные среды существуют на локальном или удаленном компьютере, выбрав "Запустить > запуск" и введя его MSINFO32.EXE. Затем выберите переменные среды программной среды>. Чтобы выбрать другой компьютер, нажмите <клавиши CTRL+R>, выберите удаленный компьютер в сети, введите имя компьютера и нажмите кнопку "ОК".

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

    Стиль отображения Описание
    Текст Пользователь будет представлен текстовым полем свободной формы для ввода значения.
    Зашифрованный текст Пользователь будет представлен маскированного текстового поля. Данные в этом поле будут зашифрованы в базе данных и не будут отображаться в журналах.
    True/False Пользователь может выбрать True или False в всплывающем диалоговом окне
    Текст с выделенным фрагментом Пользователь может выбрать из группы параметров, указанных
    Дата и время Пользователь может выбрать значение с помощью элемента управления "Выбор даты и времени"
    Файлы Пользователь может выбрать значение с помощью элемента управления "Браузер файлов"
    Папка Пользователь может выбрать значение с помощью элемента управления "Браузер папок"
    Компьютер Пользователь может выбрать значение с помощью элемента управления "Браузер компьютеров"

  10. Если параметру требуется или вы хотите указать значение по умолчанию, введите его в поле "Значение по умолчанию".

  11. Если выбран текст с выделением, поле "Параметры" включено. Чтобы добавить значения параметров, которые пользователь может выбрать, нажмите кнопку с многоточием рядом с полем "Параметры " и введите их. Каждый параметр указан в отдельной строке. После завершения добавления параметров нажмите кнопку "ОК".

  12. Завершив определение параметра, нажмите кнопку "ОК".

  13. Если этот параметр определен как параметр команды, этот параметр теперь можно добавить в командную строку, поместив курсор в нужную точку вставки в командной строке, а затем нажмите кнопку "Вставить " и выберите имя параметра. Если она определена как переменная среды, необходимо вручную ввести переменную (в формате %variable%) в командной строке.

  14. Если вы выбрали режимы запуска программы или командной строки , установите флажок для параметра "Включить рабочий каталог".

  15. Выберите вкладку "Опубликованные данные ". Параметры на этой вкладке позволяют публиковать выходные данные в шине данных Orchestrator, чтобы другие действия могли использовать эти сведения.

  16. Чтобы добавить новое опубликованное свойство данных, нажмите кнопку "Добавить".

  17. Если выбран параметр "Выполнить команду", "Запустить программу" или "Выполнить команду SSH" в раскрывающемся списке "Режим" на вкладке "Общие" диалогового окна "Добавить или изменить команду", в диалоговом окне "Добавление и изменение опубликованных данных" отображаются следующие элементы:

    Товаров Description
    Имя. Отображаемое имя создаваемого элемента опубликованных данных
    Исходный код Источник опубликованного элемента данных. Вы можете выбрать из стандартного выходного потока или стандартного потока ошибок из командной строки.
    Режим Режим, используемый для выбора опубликованных данных.

    Используйте шаблон сопоставления, чтобы определить, найден ли данный шаблон в источнике. При этом возвращается значение True или False.

    Извлечение группы для извлечения каждого элемента данных, соответствующего указанному шаблону.
    Расписание Регулярное выражение, применимое к параметру режима
    Description Текст описания, отображаемый рядом с опубликованным свойством данных в конструкторе Runbook. (необязательно).

  18. Если вы выбрали параметр "Запустить Windows PowerShell" в раскрывающемся списке "Режим" на вкладке "Общие" диалогового окна "Команда добавления и редактирования", в диалоговом окне "Добавление и изменение опубликованных данных" отображаются следующие элементы:

    Товаров Description
    Имя. Отображаемое имя создаваемого элемента опубликованных данных
    Свойство Имя свойства Windows PowerShell, которое будет сохранено в элементе опубликованных данных. Это свойство должно содержаться в выходных данных объекта в конвейере PowerShell во время скрипта и не должно быть объектом (должен быть способен преобразовать в строку).
    Description Текст описания, отображаемый рядом с опубликованным свойством данных в конструкторе Runbook. (необязательно).

  19. Нажмите кнопку "ОК ", чтобы завершить добавление элемента опубликованных данных. Повторите шаги 16–18 для каждого элемента опубликованных данных, который вы хотите добавить.

  20. Нажмите кнопку "ОК ", чтобы закрыть диалоговое окно "Добавить и изменить команду" и вернуться в диалоговое окно "Команды".

Проверка сборки действия

После создания сборки его можно протестировать с помощью действия Invoke .NET (содержащегося в IP-адресе набора средств интеграции для .NET), чтобы убедиться, что он работает должным образом, прежде чем преобразовать его в пользовательский пакет интеграции.

Тестирование сборки

Выполните следующие действия, чтобы проверить сборку:

  1. Откройте конструктор Runbook.

  2. Создайте новый модуль Runbook.

  3. В области действий выберите категорию Набора средств интеграции, чтобы развернуть ее, и перетащите действие Invoke .NET в новый модуль Runbook.

  4. Дважды щелкните объект Invoke .NET, чтобы просмотреть диалоговое окно "Свойства ".

  5. В поле "Сборка" найдите файл сборки, созданный с помощью мастера действий командной строки (или с помощью пользовательской разработки с помощью пакета SDK), нажав кнопку с многоточием (...) справа от поля. Выберите файл и нажмите кнопку "Открыть".

  6. Нажмите кнопку с многоточием справа от поля класса , чтобы просмотреть список отдельных команд в сборке. Выберите класс команды и нажмите кнопку "ОК". Параметры этого класса отображаются на вкладке "Свойства " диалогового окна.

  7. Поле установки используется только пользовательскими классами с помощью пакета SDK Orchestrator с атрибутом OrchestratorData. Дополнительные сведения о пакете SDK см. в пакете SDK system Center Orchestrator Integration Toolkit.

  8. Выберите вкладку Свойства.

  9. Укажите сведения для каждого свойства по мере необходимости.

  10. Нажмите кнопку "Готово ", чтобы сохранить параметры и вернуться в модуль Runbook.

  11. Выберите Средство тестирования Runbook на панели инструментов в конструкторе Runbook. Запускается средство тестирования Runbook.

  12. Выберите "Запустить до точки останова" на панели инструментов. Модуль Runbook запускается и выполняется действие. Результаты действия отображаются на панели " Журнал запуска".

  13. Выберите " Показать сведения" под именем действия в области "Журнал запуска", чтобы просмотреть подробные результаты, включая входные свойства и опубликованные данные.

Миграция действий командной строки QIK

Если у вас есть сборка, созданная с помощью мастера командной строки QIK 6.3 Opalis 6.3, необходимо преобразовать ее в совместимость с Orchestrator, прежде чем использовать его в пакете интеграции Orchestrator или использовать непосредственно в модулях Runbook с помощью действия Invoke .NET. Процесс преобразования прост и занимает всего несколько секунд на сборку.

Внимание

Установка набора средств интеграции Orchestrator не завершится ошибкой, если microsoft платформа .NET Framework 3.5, пакет обновления 1 не установлен, но другие операции в мастере действий командной строки завершаются ошибкой, если она отсутствует. Убедитесь, что microsoft платформа .NET Framework 3.5, пакет обновления 1 установлен перед использованием интерфейса командной строки.

Преобразование сборки интерфейса командной строки Opalis QIK

Выполните следующие действия, чтобы преобразовать сборку QIK CLI Opalis:

  1. Запустите мастер действий командной строки Orchestrator, выбрав мастер запуска > всех программ > Microsoft System Center 2012 > Orchestrator > Command-Line Activity Wizard

  2. При загрузке мастера нажмите кнопку "Загрузить существующую сборку " на первой странице.

  3. Выберите существующий файл сборки и нажмите кнопку "Открыть". Отображается имя и расположение файла сборки.

  4. Измените путь к файлу, чтобы изменения сохранялись в новом файле. При необходимости можно также изменить имя сборки.

  5. Если необходимо внести дополнительные изменения в сведения о сборке, нажмите кнопку "Сведения о сборке" и внесите эти изменения. Нажмите кнопку "ОК ", когда все готово, чтобы вернуться на страницу сведений о сборке.

  6. Нажмите кнопку "Рядом ", чтобы перейти на страницу "Команды". Вы увидите список команд, которые были ранее определены в сборке. При необходимости просмотрите команды и нажмите кнопку "Далее ", чтобы перейти на страницу сборки сборки .

  7. Новая сборка будет создана для вас и сохранена с помощью пути и имени файла, определенного ранее.

  8. Теперь вы можете использовать новую сборку, совместимую с Orchestrator, в модулях Runbook с действием Invoke .NET или создать пакет интеграции из этой сборки, нажав кнопку "Сборка пакета интеграции". Если вы не хотите создавать IP-адрес в настоящее время, нажмите кнопку "Закрыть ", чтобы завершить работу мастера.

Ресурсы Orchestrator

В дополнение к этой онлайн-ссылке, предоставленной для System Center 2012 Orchestrator, есть ряд ресурсов, которые могут предоставить дополнительную информацию о создании модулей Runbook, используя набор средств интеграции и рекомендации.