Настройка и использование командлетов Service Manager для Windows PowerShell
Важно!
Поддержка этой версии Service Manager завершена. Рекомендуем выполнить обновление до Service Manager 2022.
В этой статье приводятся общие сведения о командлетах Service Manager для интерфейса командной строки Windows PowerShell.
Перед выполнением любой команды в интерфейсе командной строки Windows PowerShell в Service Manager необходимо задать для политики выполнения значение RemoteSigned. Перед запуском командлетов хранилища данных необходимо вручную импортировать модуль командлетов хранилища данных.
Командлеты Service Manager реализованы в следующих двух модулях:
System.Center.Service.Manager. Этот модуль импортируется автоматически при каждом открытии сеанса Service Manager Windows PowerShell.
Microsoft.EnterpriseManagement.Warehouse.Cmdlets. Этот модуль необходимо импортировать вручную.
Начало работы с командлетами Service Manager
Windows PowerShell — это оболочка командной строки Windows с поддержкой интерактивной командной строки и среды сценариев. Windows PowerShell использует командлеты для управления объектами Windows PowerShell. Service Manager включает множество командлетов, которые можно использовать для выполнения различных задач, связанных с Service Manager, без использования консоли Service Manager. Например, для импорта пакета управления можно использовать командлет Import-SCSMManagementPack .
Командлеты Service Manager предоставляются в двух модулях, перечисленных ниже. В Service Manager эти модули командлетов не устанавливаются по стандартному пути, указанному в переменной $env:PSModulePath. Поэтому при выполнении командлета Get-Module -List модули Service Manager не отображаются в списке.
Командлеты администратора. Модуль System.Center.Service.Manager, содержащий командлеты, необходимые для выполнения распространенных административных задач.
Командлеты хранилища данных. Модуль Microsoft.EnterpriseManagement.Warehouse.Cmdlets, содержащий командлеты, необходимые для работы с хранилищем данных Service Manager.
Командлеты хранилища данных работают с базой данных хранилища данных, и их можно выполнять как на сервере управления Service Manager, так и на сервере управления хранилищем данных.
Данные, возвращаемые командой Windows PowerShell, могут содержать сведения, которые не удается отобразить в стандартном окне командной строки Windows PowerShell. Рекомендуется увеличить ширину командного окна: щелкните правой кнопкой мыши заголовок окна, выберите Свойства и на вкладке Макет установите для параметра Размер буфера экрана значение 120.
Следующие процедуры помогут вам приступить к работе с командлетами Service Manager.
Открытие сеанса Service Manager Windows PowerShell из консоли Service Manager
В консоли Service Manager выберите Администрирование.
В области Задачи выберите Запустить сеанс PowerShell.
Модуль командлета администратора автоматически импортируется в этом сеансе.
Открытие сеанса Service Manager Windows PowerShell из Windows
На компьютере, на котором размещен сервер управления Service Manager, на панели задач нажмите кнопку Пуск, наведите указатель на пункт Все программы и выберите Microsoft System Center.
Выберите Service Manager <версию> и оболочку Service Manager.
Модуль командлета администратора автоматически импортируется в этом сеансе.
Вывод списка всех командлетов Service Manager
Откройте сеанс Service Manager Windows PowerShell.
Чтобы получить список командлетов, включенных в модуль администратора, в сеансе Service Manager Windows PowerShell введите следующую команду и нажмите клавишу ВВОД:
Get-Command -module System.Center.Service.ManagerЧтобы получить список командлетов, включенных в модуль хранилища данных, в сеансе Service Manager Windows PowerShell введите следующую команду и нажмите клавишу ВВОД:
Get-Command -module Microsoft.EnterpriseManagement.Warehouse.Cmdlets
Справка по командлетам
Откройте сеанс Service Manager Windows PowerShell.
Теперь вы можете получить доступ к встроенной справке или использовать
-onlineпараметр для доступа к самой актуальной справке в Интернете:Введите следующую команду. Замените cmdlet-name именем командлета, для которого требуется получить справку, например Import-SCSMManagementPack:
Get-help <cmdlet-name> -detailedАктуальная справка в Интернете. Введите следующую команду и нажмите клавишу ВВОД:
Get-help <cmdlet-name> -onlineЭта команда использует
-onlineпараметр для доступа к последней интерактивной справке для командлета. Откроется веб-браузер и отображается справка в Интернете, доступная для командлета имя.
Список командлетов Service Manager
Service Manager поддерживает следующие командлеты Windows PowerShell, которые реализуются в двух модулях: в модуле администратора и модуле хранилища данных.
Командлеты администратора в модуле System.Center.Service.Manager
| Командлет | Описание |
|---|---|
| Add-SCSMAllowListClass | Добавляет указанные классы в список разрешенных классов, используемых соединителем CI Service Manager Operations Manager во время синхронизации. |
| Export-SCSMManagementPack | Экспортирует пакет управления в виде допустимого XML-файла, который позже можно импортировать в Service Manager или Operations Manager. |
| Get-SCSMAllowList | Извлекает список разрешенных классов, используемых соединителем CI Service Manager Operations Manager во время синхронизации. |
| Get-SCSMAnnouncement | Извлекает объявления, которые определены в Service Manager. |
| Get-SCSMChannel | Возвращает каналы уведомления по электронной почте, которые определены в Service Manager. |
| Get-SCSMClass | Получает класс. |
| Get-SCSMClassInstance | Извлекает объекты экземпляра класса. |
| Get-SCSMCommand | |
| Get-SCSMConnector | Извлекает соединители, которые определены в Service Manager. |
| Get-SCSMDCMWorkflow | Извлекает список требуемых рабочих процессов управления конфигурацией, определенных в Service Manager. |
| Get-SCSMDeletedItem | Извлекает элементы, помеченные для удаления в Service Manager. |
| Get-SCSMDiscovery | Извлекает сведения об обнаружении из Operations Manager и из Service Manager. |
| Get-SCSMEmailTemplate | Извлекает шаблоны сообщений электронной почты, которые определены в Service Manager. |
| Get-SCSMEmailTemplateContent | Извлекает содержимое шаблонов сообщений электронной почты Service Manager. |
| Get-SCSMGroup | Извлекает группы из Operations Manager и из Service Manager. |
| Get-SCSMManagementGroupConnection | Извлекает все подключения к группе управления, включая состояние IsActive этих подключений. Только одно подключение будет иметь значение состояния IsActive, равное True, так как одновременно может быть активным только одно подключение. |
| Get-SCSMManagementPack | Извлекает объекты, представляющие импортированные пакеты управления. |
| Get-SCSMObjectTemplate | Извлекает шаблон объекта. |
| Get-SCSMQueue | Извлекает очереди, которые определены в Service Manager. |
| Get-SCSMRelationship | Извлекает сведения об объектах связей из Operations Manager и из Service Manager. |
| Get-SCSMRelationshipInstance | Извлекает экземпляры связей из Operations Manager и из Service Manager. |
| Get-SCSMRunAsAccount | Извлекает учетные записи запуска от имени. |
| Get-SCSMSetting | Извлекает параметры конфигурации System Center Service Manager. |
| Get-SCSMSubscription | Извлекает подписки, настроенные в Service Manager. |
| Get-SCSMTask | Извлекает задачи, которые определены в Service Manager. |
| Get-SCSMUser | Извлекает пользователей, которые определены в Service Manager. |
| Get-SCSMUserRole | Извлекает роли пользователей, которые определены в Service Manager. |
| Get-SCSMView | Извлекает представления, которые определены в Service Manager. |
| Get-SCSMWorkflow | Извлекает сведения о конфигурации для рабочих процессов Service Manager. |
| Get-SCSMWorkflowStatus | Извлекает сведения о состоянии рабочих процессов в Service Manager. |
| Import-SCSMInstance | Импортирует объекты и отношения из CSV-файла в Service Manager. |
| Import-SCSMManagementPack | Импортирует пакеты управления. |
| New-SCOrchestratorConnector | Создает новый соединитель Service Manager Orchestrator. |
| New-SCRelationshipInstance | Создает экземпляр отношения. |
| New-SCSMADConnector | Создает новый соединитель Active Directory. |
| New-SCSMAlertRule | Создает правило генерации оповещений для использования с соединителем оповещений Operations Manager в Service Manager. |
| New-SCSMAnnouncement | Создает новое объявление в Service Manager. |
| New-SCSMClassInstance | Добавляет экземпляр класса в базу данных. |
| New-SCSMCMConnector | Создает новый соединитель Configuration Manager в Service Manager. |
| New-SCSMDCMWorkflow | Создает новый рабочий процесс управления требуемой конфигурацией в Service Manager. |
| New-SCSMEmailTemplate | Создает новый шаблон сообщения электронной почты для Service Manager. |
| New-SCSMManagementGroupConnection | Создает новое подключение для определенной группы управления. Последнее созданное подключение к группе управления — это активное подключение, используемое командлетами Get по умолчанию, в котором не указаны параметры ComputerName и Credential или SCSession . |
| New-SCSMManagementPack | Создает новый пакет управления. |
| New-SCSMManagementPackBundle | Компонует отдельные пакеты управления и их ресурсы, создавая новый набор пакетов управления. |
| New-SCSMOMAlertConnector | Создает новый соединитель предупреждений Operations Manager в Service Manager. |
| New-SCSMOMConfigurationItemConnector | Создает новый соединитель элементов конфигурации Operations Manager в Service Manager. |
| New-SCSMRunAsAccount | Создает новую учетную запись запуска от имени. |
| New-SCSMSubscription | Создает новую подписку в Service Manager. |
| New-SCSMUserRole | Создает новую роль пользователя в Service Manager. |
| New-SCSMWorkflow | Создает новый рабочий процесс в Service Manager. |
| New-SCVMMConnector | Создает новый соединитель Service Manager Virtual Machine Manager. |
| Protect-SCSMManagementPack | Запечатывает пакет управления, предотвращая его изменение. |
| Remove-SCSMAllowListClass | Удаляет указанные классы из списка разрешенных классов, которые используются соединителем CI Operations Manager во время синхронизации в Service Manager. |
| Remove-SCSMAnnouncement | Удаляет объявление из Service Manager. |
| Remove-SCSMClassInstance | Удаляет экземпляр объекта элемента конфигурации. |
| Remove-SCSMConnector | Удаляет соединитель из Service Manager. |
| Remove-SCSMDCMWorkflow | Удаляет требуемый рабочий процесс управления конфигурацией из Service Manager. |
| Remove-SCSMEmailTemplate | Удаляет шаблон сообщения электронной почты из Service Manager. |
| Remove-SCSMManagementGroupConnection | Удаляет подключение к группе управления. |
| Remove-SCSMManagementPack | Удаляет пакеты управления. |
| Remove-SCSMRunAsAccount | Удаляет учетные записи запуска от имени. |
| Remove-SCSMSubscription | Удаляет подписку из Service Manager. |
| Remove-SCSMUserRole | Удаляет роль пользователя из Service Manager. |
| Remove-SCSMWorkflow | Удаляет рабочий процесс из Service Manager. |
| Reset-SCSMAllowList | Сбрасывает список разрешенных классов, используемых соединителем CI Operations Manager в Service Manager в список разрешенных по умолчанию. |
| Restore-SCSMDeletedItem | Восстанавливает элементы, которые были ранее удалены в Service Manager. |
| Set-SCSMChannel | Задает свойства канала уведомления по электронной почте в Service Manager. |
| Set-SCSMManagementGroupConnection | Устанавливает указанное подключение в качестве активного. Активное соединение — это соединение, которое неявно используется при выполнении командлета Get- без указания параметров -ComputerName и -Credential или -SCSession . Только одно подключение может быть активным в любой момент, и по умолчанию активным соединением является последнее подключение, созданное с помощью командлета New-SCManagementGroupConnection . |
| Start-SCSMConnector | Запускает соединитель Service Manager. |
| Test-SCSMManagementPack | Проверяет действительность пакета управления. |
| Update-SCSMAnnouncement | Обновляет свойства объявления для Service Manager. |
| Update-SCSMClassInstance | Обновления значения свойств экземпляра класса элемента конфигурации. |
| Update-SCSMConnector | Обновления свойства соединителя Service Manager. |
| Update-SCSMDCMWorkflow | Обновления свойства требуемого рабочего процесса управления конфигурацией. |
| Update-SCSMEmailTemplate | Обновляет свойства шаблона сообщения электронной почты. |
| Update-SCSMRunAsAccount | Обновления учетные данные, связанные с учетной записью запуска от имени. |
| Update-SCSMSetting | Обновление параметров конфигурации для Service Manager. |
| Update-SCSMSubscription | Обновляет свойства подписки в Service Manager. |
| Update-SCSMUserRole | Задает свойство UserRole для пользователя Service Manager. |
| Update-SCSMWorkflow | Обновляет свойства рабочего процесса. |
Data Warehouse командлетов в модуле Microsoft.EnterpriseManagement.Warehouse.Cmdlets
| Командлет | Описание |
|---|---|
| Disable-SCDWJob | Отключает задание хранилища данных, чтобы исключить его выполнение. |
| Disable-SCDWJobSchedule | Командлет Disable-SCDWJobSchedule отключает расписание задания Data Warehouse, что приводит к прекращению запуска заданий. Если расписание задания было ранее включено, при отключении его параметры сохраняются. Чтобы изменить параметры расписания заданий, выполните командлет Set-SCDWJobSchedule . |
| Disable-SCDWSource | Включает все задания, связанные с указанным источником данных. |
| Enable-SCDWJob | Включение задания хранилища данных для запуска по расписанию. |
| Enable-SCDWJobSchedule | Командлет Enable-SCDWJobSchedule позволяет администраторам Data Warehouse включить расписания заданий, чтобы задания выполнялись по указанному расписанию. Чтобы отключить расписание заданий, используйте командлет Disable-SCDWJobSchedule . |
| Enable-SCDWSource | Включает все задания, связанные с указанным источником данных. |
| Get-SCDWEntity | Возвращает список таблиц фактов, измерений, таблиц и аутриггеров, существующих в хранилище данных. |
| Get-SCDWJob | Возвращает состояние всех повторяющихся заданий, включая задания извлечения, преобразования и загрузки (ETL). |
| Get-SCDWJobModule | Возврат подробных сведений об определенном задании. Сюда относятся модули задания, выполняемые в его составе. |
| Get-SCDWJobSchedule | Командлет Get-SCDWJobSchedule отображает сведения о планировании Data Warehouse заданий. С помощью параметра JobName можно указать задание, для которого будут отображаться сведения о планировании. В противном случае командлет Get-SCDWJobSchedule отображает сведения о планировании для всех Data Warehouse заданий. |
| Get-SCDWModule | |
| Get-SCDWRetentionPeriod | Data Warehouse выгружает строки по истечении предопределенного периода хранения. Этот командлет предоставляет период хранения для определенной сущности в минутах. Если сущность не указана, она возвращает период хранения по умолчанию для всех сущностей. |
| Get-SCDWSource | Включает все задания, связанные с указанным источником данных. |
| Get-SCDWSourceType | Возвращает типы источников данных, которые можно зарегистрировать в хранилище данных. |
| Get-SCDWWatermark | Возвращает последнюю подложку для указанного модуля задания. |
| New-SCDWSourceType | Чтобы зарегистрировать источник в Data Warehouse, сначала необходимо зарегистрировать тип источника данных в Data Warehouse. Этот командлет помогает зарегистрировать новый тип источника данных путем импорта подходящего пакета управления и внесения соответствующих изменений в конфигурацию. |
| Register-SCDWSource | Регистрирует экземпляры типов источников данных, таких как Service Manager, Operations Manager и Configuration Manager, в хранилище данных. |
| Set-SCDWJobSchedule | Настройка расписания для задания хранилища данных. |
| Set-SCDWRetentionPeriod | Задает период хранения данных в минутах для определенной таблицы фактов в конкретной базе данных хранилища данных или задает значение по умолчанию для таблиц фактов в базе данных. |
| Set-SCDWSource | Обновления определение классов и связей, которые можно заполнить для экземпляра источника данных. |
| Set-SCDWWatermark | — задает водяной знак, с которого следует продолжить последующую обработку данных. |
| Start-SCDWJob | Запуск задания хранилища данных. |
| Unregister-SCDWManagememtPack | |
| Unregister-SCDWSource | Отменяет регистрацию источника данных из хранилища данных. |
Дальнейшие действия
- Инструкции по обслуживанию заданий хранилища данных см. в статье Управление хранилищем данных.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по