Udostępnij za pośrednictwem

Start-SCOMTask

  • Odwołanie
Moduł:
OperationsManager

Uruchamia zadanie dla określonego obiektu.

Składnia

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

Opis

Polecenie cmdlet Start-SCOMTask uruchamia zadanie dla określonego obiektu. To polecenie cmdlet przyjmuje obiekt zadania i obiekt wystąpienia klasy jako dane wejściowe. Polecenie cmdlet akceptuje tylko jedno zadanie, ale może zaakceptować wiele wystąpień klas i przesłonięć.

Przykłady

Przykład 1. Uruchamianie zadania przy użyciu nazwy wyświetlanej

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

W tym przykładzie uruchamia się zadanie przy użyciu nazwy wyświetlanej.

Pierwsze polecenie pobiera wszystkie wystąpienia klas w domenie Contoso.com i przechowuje je w zmiennej $Instances.

Drugie polecenie pobiera zadanie o nazwie wyświetlanej Pobierz stan monitora i uruchamia zadanie dla każdego wystąpienia klasy przechowywanego w zmiennej $Instances.

Przykład 2. Uruchamianie zadania przy użyciu nazwy wyświetlanej i specyfikacji limitu czasu

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

W tym przykładzie pokazano, jak uruchomić zadanie przy użyciu nazwy wyświetlanej i tabeli skrótu, która określa wartość limitu czasu.

Pierwsze polecenie tworzy tabelę skrótu zawierającą wartość klucza limitu czasu i przechowuje ją w zmiennej $Overrides.

Drugie polecenie pobiera wszystkie wystąpienia klas o nazwie Contoso Service i przechowuje je w zmiennej $Instances.

Trzecie polecenie pobiera zadanie o nazwie wyświetlanej Uruchom usługę NT i uruchamia zadanie dla każdego wystąpienia klasy przechowywanego w zmiennej $Instances.

Czwarte polecenie uruchamia zadanie dla każdego wystąpienia klasy przechowywanego w zmiennej $Instances. Polecenie określa wartość klucza limitu czasu 60.

Przykład 3. Uruchamianie zadania przy użyciu poświadczeń

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

W tym przykładzie uruchamia się zadanie przy użyciu poświadczeń.

Pierwsze polecenie wyświetla użytkownikowi nazwę użytkownika i hasło, tworzy obiekt poświadczeń z danych wejściowych i przechowuje obiekt poświadczeń w zmiennej $Credential.

Drugie polecenie pobiera wystąpienie klasy o nazwie Server01.Contoso.com i przechowuje je w zmiennej $Instance.

Trzecie polecenie pobiera zadanie o nazwie wyświetlanej Reset State i uruchamia zadanie dla wystąpienia klasy przechowywanego w $Instance. Polecenie uruchamia zadanie w ramach poświadczeń przechowywanych w $Credential.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Instance

Określa tablicę obiektów EnterpriseManagementObject reprezentujących obiekty wystąpienia klasy, dla których ma być uruchamiane zadanie. Określ zmienną, która przechowuje wystąpienia klas lub użyj polecenia cmdlet, takiego jak polecenie cmdlet Get-SCOMClassInstance , które pobiera wystąpienia klas. Ten parametr akceptuje również obiekty grupy. Aby uzyskać obiekt grupy, użyj polecenia cmdlet Get-SCOMGroup .

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Override

Określa tabelę skrótów, która definiuje nowe wartości dla co najmniej jednego parametru zadania, jeśli te parametry zezwalają na przesłonięcia. Aby uzyskać więcej informacji na temat tabel skrótów, wpisz "Get-Help about_Hash_Tables".

Aby określić, które parametry dla zadania zezwalają na przesłonięcia, użyj metody GetOverrideableParameters dla obiektu zadania.

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Task

Określa obiekt zadania do uruchomienia. Określ zmienną reprezentującą zadanie lub użyj polecenia cmdlet, takiego jak polecenie cmdlet Get-SCOMTask , które pobiera zadanie. Ten parametr akceptuje tylko jeden obiekt zadania.

Type:ManagementPackTask
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TaskCredentials

Określa konto użytkownika, w ramach którego jest uruchamiane połączenie grupy zarządzania. Określ obiekt PSCredential , taki jak obiekt zwracany przez polecenie cmdlet Get-Credential , dla tego parametru. Aby uzyskać więcej informacji na temat obiektów poświadczeń, wpisz "Get-Help Get-Credential".

To konto musi mieć dostęp do serwera określonego w parametrze ComputerName , jeśli zostanie wyświetlony ten parametr.

Ten parametr jest wymagany . Jeśli określisz wartość null, program Operations Manager używa domyślnych obiektów TaskCredentials konta dla bieżącego użytkownika.

Type:PSCredential
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False