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

Start-SCOMTask

  • Ссылка
Модуль:
OperationsManager

Запускает задачу для указанного объекта.

Синтаксис

Start-SCOMTask
     [-Instance] <EnterpriseManagementObject[]>
     [-Task] <ManagementPackTask>
     -TaskCredentials <PSCredential>
     [[-Override] <Hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Описание

Командлет Start-SCOMTask запускает задачу для указанного объекта. Этот командлет принимает объект задачи и объект экземпляра класса в качестве входных данных. Командлет принимает только одну задачу, но может принимать несколько экземпляров классов и переопределения.

Примеры

Пример 1. Запуск задачи с помощью отображаемого имени

PS C:\>$Instances = Get-SCOMClassInstance -Name "*.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Get Monitor State" | Start-SCOMTask -Instance $Instances

В этом примере запускается задача с помощью отображаемого имени.

Первая команда получает все экземпляры классов в домене Contoso.com и сохраняет их в переменной $Instances.

Вторая команда получает задачу с отображаемым именем Get Monitor State и запускает задачу для каждого экземпляра класса, хранящегося в переменной $Instances.

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

PS C:\>$Overrides = @{Timeout=60}
PS C:\> $Instances = Get-SCOMClassInstance -DisplayName "Contoso Service"
PS C:\> $Task = Get-SCOMTask -DisplayName "Start NT Service"
PS C:\> Start-SCOMTask -Task $Task -Instance $Instances -Override $Overrides

В этом примере показано, как запустить задачу с помощью отображаемого имени и хэш-таблицы, указывающей значение времени ожидания.

Первая команда создает хэш-таблицу с значением ключа timeout и сохраняет ее в переменной $Overrides.

Вторая команда получает все экземпляры классов с именем Contoso Service и хранят их в переменной $Instances.

Третья команда получает задачу с отображаемым именем Start NT Service и запускает задачу для каждого экземпляра класса, хранящегося в переменной $Instances.

Четвертая команда запускает задачу для каждого экземпляра класса, хранящегося в переменной $Instances. Команда задает значение ключа timeout 60.

Пример 3. Запуск задачи с помощью учетных данных

PS C:\>$Credential = Get-Credential
PS C:\> $Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Reset State" | Start-SCOMTask -Instance $Instance -TaskCredentials $Credential

В этом примере выполняется задача с помощью учетных данных.

Первая команда запрашивает имя пользователя и пароль, создает объект учетных данных из входных данных и сохраняет объект учетных данных в переменной $Credential.

Вторая команда получает экземпляр класса с именем Server01.Contoso.com и сохраняет его в переменной $Instance.

Третья команда получает задачу с состоянием сброса отображаемого имени и запускает задачу для экземпляра класса, хранящегося в $Instance. Команда выполняет задачу под учетными данными, хранящимися в $Credential.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Instance

Задает массив объектов EnterpriseManagementObject, представляющих объекты экземпляра класса, для которых нужно запустить задачу. Укажите переменную, в которой хранятся экземпляры класса или используйте командлет, например командлет Get-SCOMClassInstance, который получает экземпляры класса. Этот параметр также принимает объекты группы. Чтобы получить объект группы, используйте командлет Get-SCOMGroup.

Тип:EnterpriseManagementObject[]
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Override

Указывает хэш-таблицу, которая определяет новые значения для одного или нескольких параметров задачи, если эти параметры разрешают переопределения. Дополнительные сведения о хэш-таблицах введите "Get-Help about_Hash_Tables".

Чтобы определить, какие параметры для задачи разрешают переопределения, используйте метод GetOverrideableParameters для объекта задачи.

Тип:Hashtable
Position:4
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Task

Указывает объект задачи для запуска. Укажите переменную, представляющую задачу, или используйте командлет, например командлет Get-SCOMTask, который получает задачу. Этот параметр принимает только один объект задачи.

Тип:ManagementPackTask
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TaskCredentials

Указывает учетную запись пользователя, в которой выполняется подключение группы управления. Укажите объект PSCredential, например объект get-Credential для этого параметра. Дополнительные сведения об объектах учетных данных введите "Get-Help Get-Credential".

Эта учетная запись должна иметь доступ к серверу, указанному в параметре ComputerName, если этот параметр отображается.

Это обязательный параметр. Если указать значение NULL, Operations Manager использует значения taskCredentials учетной записи текущего пользователя по умолчанию.

Тип:PSCredential
Position:3
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False