Start-SCOMTask
Uruchamia zadanie dla określonego obiektu.
Składnia
Default (Domyślna)
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 akceptować 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 zadanie jest uruchamiane przy użyciu nazwy wyświetlanej.
Pierwsze polecenie pobiera wszystkie instancje klas w domenie Contoso.com i zapisuje je w zmiennej $Instances.
Drugie polecenie pobiera zadanie o nazwie wyświetlanej Pobierz stan monitora i uruchamia zadanie dla każdego wystąpienia klasy, które jest przechowywane 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ótów, która określa wartość limitu czasu.
Pierwsze polecenie tworzy tabelę skrótów, która ma wartość klucza Timeout i przechowuje ją w zmiennej $Overrides.
Drugie polecenie pobiera wszystkie wystąpienia klas o nazwie Contoso Service i zapisuje je w zmiennej $Instances.
Trzecie polecenie pobiera zadanie o nazwie wyświetlanej Start NT Service i uruchamia zadanie dla każdej instancji klasy, która jest przechowywana w zmiennej $Instances.
Czwarte polecenie uruchamia zadanie dla każdej instancji klasy, która jest przechowywana w zmiennej $Instances. Polecenie określa wartość klucza limitu czasu równą 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 zadanie jest uruchamiane przy użyciu poświadczeń.
Pierwsze polecenie monituje użytkownika o podanie nazwy użytkownika i hasła, tworzy obiekt poświadczeń na podstawie danych wejściowych i zapisuje obiekt poświadczeń w zmiennej $Credential.
Drugie polecenie pobiera instancję klasy o nazwie Server01.Contoso.com i zapisuje ją w zmiennej $Instance.
Trzecie polecenie pobiera zadanie o nazwie wyświetlanej Reset State i uruchamia zadanie dla instancji klasy, która jest przechowywana w $Instance. Polecenie uruchamia zadanie w ramach poświadczeń przechowywanych w programie $Credential.
Parametry
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Instance
Określa tablicę obiektów EnterpriseManagementObject , które reprezentują obiekty instancji klasy, dla których ma zostać uruchomione zadanie. Określ zmienną, która przechowuje wystąpienia klasy, lub użyj polecenia cmdlet, takiego jak polecenie cmdlet Get-SCOMClassInstance , które pobiera wystąpienia klasy. Ten parametr akceptuje również obiekty grupowe. Aby uzyskać obiekt grupy, użyj polecenia cmdlet Get-SCOMGroup .
Właściwości parametru
| Typ: | EnterpriseManagementObject[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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 zadania zezwalają na przesłonięcia, użyj metody GetOverrideableParameters dla obiektu zadania.
Właściwości parametru
| Typ: | Hashtable |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 4 |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | ManagementPackTask |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 2 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-TaskCredentials
Określa konto użytkownika, w ramach którego jest uruchamiane połączenie grupy zarządzania.
Określ obiekt PSCredential , taki jak ten, który jest 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 NazwaKomputera , jeśli ten parametr zostanie wyświetlony.
Jest to obowiązkowy parametr. Jeśli określisz wartość null, program Operations Manager użyje domyślnych poświadczeń zadania konta dla bieżącego użytkownika.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 3 |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.