Zarządzanie elementami Runbook dla usługi Service Management Automation
Jako administrator usługi Service Management Automation (SMA) należy skonfigurować i uruchomić elementy Runbook. Działania, w tym konfigurowanie procesów roboczych elementów Runbook oraz planowanie i śledzenie elementów Runbook. Istnieją dwa elementy Runbook systemu dołączone do programu SMA oprócz elementów Runbook utworzonych przez Ciebie:
- DiscoverAllLocalModules: uruchamia się natychmiast po zainstalowaniu procesu roboczego elementu Runbook. Ten element Runbook odnajduje wszystkie moduły natywne w systemie Windows Server, na którym jest zainstalowany proces roboczy elementu Runbook. Wyodrębnia on działania i metadane działań dla tych modułów, aby można było ich używać podczas tworzenia elementów runbook w pakiecie Microsoft Azure Pack.
- SetAutomationModuleActivityMetadata: uruchamia się natychmiast po zaimportowaniu modułu do programu SMA. Ten element Runbook wyodrębnia działania i metadane działań z nowo zaimportowanego modułu, dzięki czemu jego działania mogą być używane podczas tworzenia elementów Runbook w pakiecie Microsoft Azure Pack.
Konfigurowanie procesów roboczych elementów Runbook
Domyślnie po uruchomieniu zadania elementu Runbook w programie SMA jest wybierany przez losowy proces roboczy elementu Runbook. Możesz jednak chcieć użyć określonego procesu roboczego elementu Runbook. W tym celu użyj właściwości RunbookWorker . Dowiedz się więcej na temat wykonywania elementu Runbook.
Wyznaczanie procesu roboczego elementu Runbook za pomocą dodatku ISE programu PowerShell.
- W konfiguracji dodatku >SMA ISE zaloguj się przy użyciu konta SMA. Po zalogowaniu możesz zobaczyć elementy Runbook na karcie Elementy Runbook .
- Na karcie Elementy Runbook wybierz co najmniej jeden element Runbook do uruchomienia względem określonego procesu roboczego elementu Runbook.
- Wybierz pozycję Konfiguruj, a następnie w obszarze Konfigurowanie właściwości elementu Runbook wybierz proces roboczy elementu Runbook z menu rozwijanego.
- Wybierz pozycję Wprowadź zmiany.
Wyznaczanie procesu roboczego elementu Runbook za pomocą modułu SMA programu PowerShell
Można również ustawić właściwość procesu roboczego elementu Runbook przy użyciu następującego polecenia wiersza polecenia:
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Sample-TestRunbook"
$workerName = "Worker1"
Set-SmaRunbookConfiguration -WebServiceEndpoint $webServer -Port $port -Name $runbookName -RunbookWorker $workerName
Listę wszystkich procesów roboczych elementów Runbook wdrożonych można wyświetlić w następujący sposób:
$webServer = 'https://MyServer'
$port = 9090
Get-SmaRunbookWorkerDeployment -WebServiceEndpoint $webServer -Port $port
Uwaga
Obecnie nie można użyć portalu microsoft Azure Pack do wyznaczenia procesu roboczego elementu runbook. Użyj dodatków SMA ISE lub poleceń cmdlet programu PowerShell.
Planowanie elementów Runbook
Aby zaplanować uruchamianie elementu Runbook o określonej godzinie, należy połączyć go z co najmniej jednym harmonogramem. Harmonogram można skonfigurować do uruchamiania raz lub ustawić na rekurs. Element Runbook może zostać powiązany z wieloma harmonogramami, a harmonogram może zostać powiązany z wieloma elementami Runbook.
Tworzenie harmonogramu
Harmonogram można utworzyć za pomocą portalu zarządzania lub programu Windows PowerShell.
Tworzenie harmonogramu w portalu zarządzania
- W Portalu zarządzania wybierz opcję Automatyzacja.
- Na karcie Zasoby wybierz pozycję Dodaj ustawienie>Dodaj harmonogram.
- Wprowadź nazwę i opis nowego harmonogramu, a następnie wybierz, czy zostanie uruchomiony jednorazowo , czy codziennie.
- Określ godzinę rozpoczęcia i inne opcje zgodnie z potrzebami. Strefa czasowa godziny rozpoczęcia będzie zgodna ze strefą czasową komputera lokalnego.
Tworzenie harmonogramu za pomocą programu Windows PowerShell
Możesz użyć polecenia cmdlet Set-SmaSchedule , aby utworzyć harmonogram lub zmodyfikować istniejący harmonogram. Musisz określić godzinę rozpoczęcia harmonogramu i określić, czy ma być uruchamiany raz, czy wielokrotnie.
Poniższy przykład tworzy nowy harmonogram o nazwie Mój dzienny harmonogram. Rozpoczyna się on w bieżącym dniu i trwa przez jeden rok każdego dnia w południe.
$webServer = 'https://MyServer'
$port = 9090
$scheduleName = 'My Daily Schedule'
$startTime = (Get-Date).Date.AddHours(12)
$expiryTime = $startTime.AddYears(1)
Set-SmaSchedule -WebServiceEndpoint $webServer -Port $port -Name $scheduleName -ScheduleType OneTimeSchedule -StartTime $startTime -ExpiryTime $expiryTime -DayInterval 1
Łączenie harmonogramu z elementem Runbook
Element Runbook może zostać powiązany z wieloma harmonogramami, a harmonogram może zostać powiązany z wieloma elementami Runbook. Jeśli element Runbook ma parametry, możesz podać wartości, które mają być używane podczas uruchamiania elementu Runbook. Należy podać wartości parametrów obowiązkowych.
Łączenie harmonogramu w portalu zarządzania
- W portalu zarządzania wybierz pozycję Elementy Runbook usługi Automation>.
- Wybierz nazwę elementu Runbook, aby zaplanować, a następnie wybierz kartę Harmonogram .
- Jeśli element Runbook jest obecnie połączony z harmonogramem, wybierz pozycję Połącz. Następnie wybierz pozycję Połącz z nowym harmonogramem i utwórz nowy lub wybierz pozycję Połącz z istniejącym harmonogramem i wybierz harmonogram.
- Jeśli element Runbook ma parametry, zostanie wyświetlony monit o podanie ich wartości.
Harmonogram łączenia z programem Windows PowerShell
W celu powiązania harmonogramu z elementem Runbook można użyć polecenia Start-SmaRunbook z parametrem ScheduleName . Wartości można określić za pomocą parametru Parameters . Dowiedz się więcej o wartościach parametrów.
Następujące przykładowe polecenia pokazują, jak powiązać harmonogram z elementem Runbook.
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scheduleName = "Sample-DailySchedule"
Start-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName -ScheduleName $scheduleName -Parameters $params
Śledzenie elementów Runbook
Po uruchomieniu elementu Runbook w programie SMA zostanie utworzone zadanie. Zadanie jest pojedynczym wystąpieniem wykonania elementu Runbook. Pojedynczy element Runbook może mieć wiele zadań, z których każdy ma własny zestaw wartości parametrów elementu Runbook.
- Jeśli właściwość RunbookWorker elementu Runbook zostanie wypełniona, serwer roboczy będzie obsługiwać zadanie.
- Jeśli serwer roboczy jest niedostępny, zadanie zakończy się niepowodzeniem z powodu błędu.
- Jeśli właściwość RunbookWorker nie zostanie wypełniona, program SMA losowo wybierze dostępny serwer roboczy do obsługi żądania.
Na poniższym diagramie przedstawiono cykl życia zadania elementu Runbook dla elementów Runbook przepływu pracy programu PowerShell.
Na poniższym diagramie przedstawiono cykl życia zadania elementu Runbook dla elementów Runbook skryptów programu PowerShell.
Stan zadania
W poniższej tabeli opisano różne stany, które może przyjmować zadanie.
Stan | opis |
---|---|
Ukończone | Zadanie zostało ukończone pomyślnie. |
Niepowodzenie | Zadanie zakończone z powodu wyjątku. |
W kolejce | Zadanie oczekuje na dostępność zasobów dla procesu roboczego automatyzacji, tak aby można było je uruchomić. |
Uruchamianie | Zadanie zostało przypisane do procesu roboczego, a system jest w trakcie jego uruchamiania. |
Wznawianie | System jest w trakcie wznawiania zadania po tym, jak zostało wstrzymane. |
Uruchomiono | Zadanie jest uruchomione. |
Zatrzymana | Zadanie zostało zatrzymane przez użytkownika przed jego ukończeniem. |
Zatrzymywanie | System jest w trakcie zatrzymywania zadania. |
Suspended | Zadanie zostało zawieszone przez użytkownika, przez system lub za pomocą polecenia w elemencie Runbook. Zadanie, które zostało zawieszone, można uruchomić ponownie. Zostanie wznowione z ostatniego punktu kontrolnego lub od początku elementu Runbook, jeśli nie ma punktów kontrolnych. Element Runbook jest zawieszony tylko przez system w przypadku wyjątku, który ma możliwość wznowienia. Domyślnie właściwość ErrorActionPreference jest ustawiona na Wartość Kontynuuj, co oznacza, że zadanie działa po wystąpieniu wyjątku. Jeśli ta zmienna ma wartość Zatrzymaj, zadanie zostanie zawieszone po wystąpieniu wyjątku. |
Zawieszanie | System próbuje zawiesić zadanie na żądanie użytkownika. Przez zawieszeniem element Runbook musi dotrzeć do swojego następnego punktu kontrolnego. Jeśli punkt kontrolny został już przekazany, zostanie on ukończony, zanim będzie można go zawiesić. |
Wyświetlanie stanu zadania w portalu zarządzania
Pulpit nawigacyjny usługi Automation zawiera podsumowanie wszystkich elementów Runbook w środowisku SMA.
- Wykres podsumowania przedstawia łączną liczbę zadań dla wszystkich elementów Runbook znajdujących się w danym stanie podczas podanej liczby dni lub godzin.
- Zakres czasu można wybrać w prawym górnym rogu wykresu.
- Oś czasu wykresu zmienia się zgodnie z wybranym typem zakresu czasu.
- Możesz wybrać, czy wiersz ma być wyświetlany dla określonego stanu, klikając go w górnej części ekranu.
Wyświetl pulpit nawigacyjny w następujący sposób:
- W Portalu zarządzania wybierz opcję Automatyzacja.
- Wybierz kartę Pulpit nawigacyjny.
Wyświetlanie pulpitu nawigacyjnego
Pulpit nawigacyjny elementu Runbook zawiera podsumowanie dla jednego elementu Runbook. Wykres podsumowujący przedstawia łączną liczbę zadań dla elementu Runbook znajdujących się w danym stanie podczas podanej liczby dni lub godzin. Zakres czasu można wybrać w prawym górnym rogu wykresu. Oś czasu wykresu zmienia się zgodnie z wybranym typem zakresu czasu. Możesz wybrać, czy wiersz ma być wyświetlany dla określonego stanu, klikając go w górnej części ekranu.
Wyświetl pulpit nawigacyjny w następujący sposób:
- W Portalu zarządzania wybierz opcję Automatyzacja.
- Wybierz nazwę elementu Runbook.
- Wybierz kartę Pulpit nawigacyjny.
Wyświetlanie szczegółów zadania
Możesz wyświetlić listę wszystkich zadań, które zostały utworzone dla określonego elementu Runbook i ich najnowszego stanu.
- Listę można filtrować według stanu zadania i zakresu dat dla ostatniej zmiany zadania.
- Wybierz nazwę zadania, aby wyświetlić jego szczegółowe informacje i jego dane wyjściowe.
- Widok szczegółowy zadania zawiera wartości parametrów elementu Runbook udostępnione danemu zadaniu.
- Historia zadań zawiera dane wyjściowe, ostrzeżenia i komunikaty o błędach wraz z sygnaturą czasową utworzenia rekordu.
- Dowiedz się więcej o danych wyjściowych i komunikatach elementu Runbook.
- Źródło zadania jest kodem źródłowym przepływu pracy podczas uruchomienia zadania. Ta wartość może się różnić od bieżącej wersji elementu Runbook, jeżeli został on zaktualizowany po uruchomieniu zadania.
Następujące kroki służą do wyświetlania zadań elementu Runbook.
- W Portalu zarządzania wybierz opcję Automatyzacja.
- Wybierz nazwę elementu Runbook i wybierz kartę Zadania .
- Wybierz kolumnę Job Created (Utworzono zadanie) dla zadania, aby wyświetlić jego szczegóły i dane wyjściowe.
- Wybierz kartę Historia , aby wyświetlić historię zadania. Wybierz rekord historii i wybierz pozycję Wyświetl szczegóły w dolnej części ekranu, aby wyświetlić szczegółowy widok rekordu.
- Na karcie Historia wybierz pozycję Wyświetl źródło.
Pobieranie stanu zadania przy użyciu programu Windows PowerShell
Do pobrania zadań utworzonych dla elementu Runbook i szczegółów dotyczących określonego zadania można użyć polecenia cmdlet Get-SmaJob .
- Jeśli uruchomisz element runbook przy użyciu programu Windows PowerShell przy użyciu polecenia Start-SmaRunbook, zwraca ono wynikowe zadanie.
- Użyj polecenia Get-SmaJobOutput , aby uzyskać dane wyjściowe zadania.
Następujące przykładowe polecenie pobiera ostatnie zadanie dla przykładowego elementu Runbook i wyświetla jego stan, wartości podane dla parametrów elementu Runbook i dane wyjściowe z zadania.
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$job = (Get-SmaJob -WebServiceEndpoint $webServer -Port $port -RunbookName $runbookName | sort LastModifiedDate -desc)[0]
$job.Status
$job.JobParameters
Get-SmaJobOutput -WebServiceEndpoint $webServer -Port $port -Id $job.Id -Stream Output
Konfigurowanie ustawień elementu Runbook
Każdy element Runbook ma wiele ustawień. Te ustawienia ułatwiają lokalizowanie elementów Runbook i zarządzanie nimi. Rejestrowanie elementu Runbook można również zmienić, konfigurując te ustawienia. Każde z tych ustawień zostało opisane poniżej, a następnie procedury dotyczące sposobu ich modyfikowania.
Nazwa i opis
Nie można zmienić nazwy elementu Runbook po jego utworzeniu. Pole Opis jest opcjonalne i może zawierać maksymalnie 512 znaków.
Tagi
Znaczniki umożliwiają przypisywanie unikatowych słów i wyrażeń w celu ułatwienia identyfikacji elementu Runbook. Można określić wiele znaczników elementu Runbook, rozdzielając je średnikami.
Rejestrowanie
Domyślnie rekordy Pełne i Postęp nie są zapisywane w historii zadań. Aby móc zapisywać te rekordy, można zmienić ustawienia określonego elementu Runbook. Aby uzyskać więcej informacji na temat tych rekordów, zobacz Runbook Output and Messages.
Wyznaczony proces roboczy elementu Runbook
Domyślnie zadanie elementu Runbook ma być przypisane do losowego procesu roboczego elementu Runbook do wykonania. Możesz zmienić ustawienia określonego elementu Runbook, aby wykonać element Runbook w określonym procesu roboczego elementu Runbook.
Zmienianie ustawień elementu Runbook w portalu zarządzania
Ustawienia elementu Runbook można zmienić w portalu zarządzania na stronie Konfigurowanie elementu Runbook.
W Portalu zarządzania wybierz opcję Automatyzacja.
Wybierz kartę Elementy Runbook .
Wybierz nazwę elementu Runbook.
Wybierz kartę Konfigurowanie.
Zmienianie ustawień elementu Runbook przy użyciu programu PowerShell
Możesz użyć polecenia cmdlet Set-SmaRunbookConfiguration , aby zmienić wszystkie ustawienia elementu Runbook z wyjątkiem tagów. Tagi dla istniejących elementów Runbook można zmieniać i dodawać tylko przy użyciu portalu zarządzania. Tagi elementów Runbook można ustawić tylko za pomocą programu PowerShell podczas importowania elementu Runbook przy użyciu elementu Import-SmaRunbook.
Następujące przykładowe polecenia pokazują, jak ustawić właściwości elementu Runbook. Ten przykład dodaje opis i określa, że pełne rekordy powinny być rejestrowane:
$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Sample-TestRunbook"
Set-SmaRunbookConfiguration -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Description "Sample runbook" -LogVerbose $true
Szyfrowanie połączenia procesu roboczego elementu Runbook i serwera SQL
Zabezpiecz połączenie między procesami roboczymi elementu Runbook i serwerem SQL przy użyciu protokołu SSL.
Następne kroki
- Przeczytaj o zarządzaniu globalnymi zasobami.
- Dowiedz się więcej o roli smA w implementacji pakietu Microsoft Azure Pack.