Start-SCOMTask
Запускает задачу для указанного объекта.
Синтаксис
Default (по умолчанию)
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 |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Instance
Задает массив объектов EnterpriseManagementObject, представляющих объекты экземпляра класса, для которых нужно запустить задачу. Укажите переменную, в которой хранятся экземпляры класса или используйте командлет, например командлет Get-SCOMClassInstance, который получает экземпляры класса. Этот параметр также принимает объекты группы. Чтобы получить объект группы, используйте командлет Get-SCOMGroup.
Свойства параметра
| Тип: | EnterpriseManagementObject[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Override
Указывает хэш-таблицу, которая определяет новые значения для одного или нескольких параметров задачи, если эти параметры разрешают переопределения.
Дополнительные сведения о хэш-таблицах введите "Get-Help about_Hash_Tables".
Чтобы определить, какие параметры для задачи разрешают переопределения, используйте метод GetOverrideableParameters для объекта задачи.
Свойства параметра
| Тип: | Hashtable |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 4 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Task
Указывает объект задачи для запуска. Укажите переменную, представляющую задачу, или используйте командлет, например командлет Get-SCOMTask, который получает задачу. Этот параметр принимает только один объект задачи.
Свойства параметра
| Тип: | ManagementPackTask |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 2 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-TaskCredentials
Указывает учетную запись пользователя, в которой выполняется подключение группы управления.
Укажите объект PSCredential, например объект get-Credential для этого параметра.
Дополнительные сведения об объектах учетных данных введите "Get-Help Get-Credential".
Эта учетная запись должна иметь доступ к серверу, указанному в параметре ComputerName, если этот параметр отображается.
Это обязательный параметр. Если указать значение NULL, Operations Manager использует значения taskCredentials учетной записи текущего пользователя по умолчанию.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 3 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.