Start-DbaAgentJob

Start-DbaAgentJob to polecenie modułu dbatools uruchamiające zadanie SQL Server Agent z poziomu skryptu PowerShell.

Rola Start-DbaAgentJob w module dbatools

Start-DbaAgentJob jest poleceniem modułu dbatools dla programu PowerShell, przeznaczonym do uruchamiania istniejących zadań usługi SQL Server Agent. Polecenie nie tworzy nowego zadania i nie definiuje jego kroków. Wskazuje instancję SQL Server oraz zadanie, które ma zostać rozpoczęte. Sama operacja jest wykonywana przez SQL Server Agent, a PowerShell pełni funkcję warstwy sterującej.

Zadanie SQL Server Agent, określane w dokumentacji jako job, składa się między innymi z kroków, harmonogramów, warunków wykonania i informacji o właścicielu. Start-DbaAgentJob korzysta z konfiguracji zapisanej w instancji SQL Server. Oznacza to, że rezultat uruchomienia zależy od definicji konkretnego zadania, jego kroków oraz bieżącego stanu usługi SQL Server Agent. Polecenie nie zastępuje mechanizmu harmonogramowania ani ręcznej konfiguracji joba w SQL Server Management Studio.

Wskazanie instancji i zadania do uruchomienia

Podstawowe użycie polecenia polega na przekazaniu nazwy lub adresu instancji SQL Server oraz nazwy zadania. Przykładowa forma może wyglądać następująco: Start-DbaAgentJob -SqlInstance 'SQL01' -Job 'Kopia bazy'. Nazwa zadania musi odpowiadać jobowi istniejącemu na wskazanej instancji. Jeżeli na serwerze znajduje się kilka zadań o podobnych nazwach, należy jednoznacznie określić właściwy obiekt, aby nie uruchomić niewłaściwego procesu.

W środowisku, w którym wymagane są jawnie przekazane poświadczenia, dbatools umożliwia użycie parametru -SqlCredential z obiektem PSCredential. Sposób uwierzytelniania musi być zgodny z konfiguracją SQL Server i uprawnieniami konta wykonującego operację. Do poprawnego działania potrzebny jest dostęp do instancji oraz możliwość odczytu i uruchamiania zadań SQL Server Agent. Brak odpowiednich uprawnień może spowodować błąd autoryzacji, nawet gdy sama składnia polecenia jest poprawna.

Stan wykonania i interpretacja wyniku

Uruchomienie zadania nie oznacza zakończenia wszystkich jego kroków. SQL Server Agent przyjmuje żądanie startu i wykonuje job zgodnie z jego konfiguracją. Jeżeli zadanie zawiera kilka kroków, ich wykonanie może trwać dłużej niż samo wywołanie polecenia PowerShell. Z tego powodu wynik Start-DbaAgentJob należy odróżnić od informacji o końcowym sukcesie lub niepowodzeniu zadania. Do oceny rezultatu trzeba sprawdzić historię joba, bieżący stan oraz komunikaty generowane przez SQL Server Agent.

Znaczenie ma również sytuacja, w której zadanie jest już uruchomione, wyłączone albo nie może zostać rozpoczęte z powodu konfiguracji instancji. Problemy mogą wynikać między innymi z zatrzymanej usługi SQL Server Agent, niedostępnych zasobów używanych przez krok, nieprawidłowego właściciela joba lub błędów w poleceniach wykonywanych przez samo zadanie. Diagnostyka powinna więc obejmować nazwę instancji, nazwę joba, uprawnienia, stan usługi oraz historię wykonania, a nie tylko komunikat zwrócony przez PowerShell.

Znaczenie polecenia w diagnostyce środowiska SQL Server

Start-DbaAgentJob jest przydatne podczas testowania zadań wykonywanych cyklicznie, sprawdzania reakcji na ręczne uruchomienie oraz automatyzowania powtarzalnych czynności administracyjnych w SQL Server. Pozwala wywołać zadanie z poziomu skryptu PowerShell bez konieczności otwierania graficznego interfejsu zarządzającego. W praktyce ułatwia to porównanie zachowania joba uruchamianego ręcznie i według harmonogramu, ale nie usuwa potrzeby analizy logów SQL Server Agent oraz historii kroków.

Przed użyciem warto potwierdzić, że wskazana instancja jest właściwa, zadanie ma oczekiwaną nazwę, a jego kroki nie wykonują operacji poza zakładanym zakresem. Należy także uwzględnić zależności między jobami, czas działania oraz możliwość równoczesnego uruchomienia tego samego zadania przez harmonogram. W przypadku problemów z laptopem lub komputerem PC, na którym przygotowywany jest skrypt PowerShell albo narzędzie do zarządzania środowiskiem, Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów i komputerów stacjonarnych PC oraz ich podzespołów.