Tworzenie elementów Runbook automatyzacji zarządzania usługami

Elementy Runbook w usługach Service Management Automation i Microsoft Azure Automation to przepływy pracy programu Windows PowerShell lub skrypty programu PowerShell. Zapewniają one możliwość automatyzowania procesów administracyjnych do zarządzania serwerami w chmurze i wdrażania ich lub dowolnej innej funkcji, którą może wykonać skrypt programu Windows PowerShell.

Nie ma różnicy w elementach Runbook między dwoma systemami, a ten sam element Runbook może działać na obu tych samych elementach z identycznymi funkcjami. Termin Automatyzacja jest używany w tym artykule, odnosi się zarówno do automatyzacji zarządzania usługami, jak i usługi Microsoft Azure Automation.

Dodatkowe usługi udostępniane przez usługę Automation do pracy z przepływami pracy programu Windows PowerShell obejmują następujące elementy:

• Scentralizowany magazyn elementów Runbook i zarządzanie nimi.

• Skalowalna architektura do planowania i uruchamiania elementów Runbook.

• Zasoby globalne, które są centralnie zarządzane i dostępne dla wszystkich elementów Runbook.

• Interfejs użytkownika do tworzenia i testowania elementów Runbook.

• Zestaw poleceń cmdlet do zarządzania i uruchamiania elementów Runbook.

Tworzenie lub importowanie elementu Runbook

Element Runbook można dodać do usługi Service Management Automation, tworząc go w portalu zarządzania lub importując go z pliku.

Tworzenie elementu Runbook w portalu zarządzania

1. W portalu zarządzania wybierz pozycję Nowy, App Services, Automation, Runbook, Quick Create.

2. Wprowadź wymagane informacje, a następnie wybierz pozycję Utwórz. Nazwa elementu Runbook musi zaczynać się literą i może zawierać litery, cyfry, podkreślenia i kreski.

3. Jeśli chcesz teraz edytować element Runbook, wybierz pozycję Edytuj element Runbook. W przeciwnym razie wybierz przycisk OK.

4. Nowy element Runbook zostanie wyświetlony na karcie Elementy Runbook .

Importowanie elementu Runbook z pliku

1. W portalu zarządzania wybierz pozycję Automatyzacja , a następnie wybierz konto usługi Automation.

2. Wybierz Importuj.

3. Wybierz pozycję Przeglądaj w polu Plik i znajdź plik skryptu do zaimportowania.

4. Jeśli chcesz teraz edytować element Runbook, wybierz pozycję Edytuj element Runbook. W przeciwnym razie wybierz przycisk OK.

5. Nowy element Runbook zostanie wyświetlony na karcie Elementy Runbook dla konta usługi Automation.

Importowanie elementu Runbook z pliku skryptu za pomocą programu Windows PowerShell

Możesz użyć polecenia cmdlet Import-SmaRunbook , aby utworzyć nowy element Runbook z pliku skryptu zawierającego przepływ pracy.

Poniższe przykładowe polecenia pokazują, jak zaimportować plik skryptu do istniejącego elementu Runbook, a następnie opublikować go.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

Import-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Path $scriptPath
Publish-SMARunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName

Edytowanie elementu Runbook

Każdy element Runbook w usłudze Service Management Automation ma dwie wersje: Wersja robocza i Opublikowana. Edytujesz wersję roboczą przepływu pracy, a następnie opublikujesz go, aby można było go wykonać. Nie można edytować wersji opublikowanej.

Edytowanie elementu Runbook za pomocą portalu zarządzania

Portal zarządzania zawiera edytor, którego można użyć do wyświetlania i edytowania elementów Runbook. Oprócz zapewniania podstawowych możliwości edytowania tekstu edytor zapewnia możliwość automatycznego wstawiania kodu dla elementów Runbook, globalnych zasobów i działań.

1. W Portalu zarządzania wybierz opcję Automatyzacja.

2. Wybierz kartę Elementy Runbook .

3. Wybierz nazwę elementu Runbook, który chcesz edytować.

4. Wybierz kartę Autor .

5. Wybierz pozycję Wersja robocza w górnej części ekranu lub przycisk Edytuj w dolnej części ekranu.

6. Wykonaj wymaganą edycję.

7. Po zakończeniu edycji wybierz pozycję Zapisz .

8. Wybierz pozycję Publikuj , jeśli chcesz opublikować najnowszą wersję roboczą elementu Runbook.

Wybierz wymaganą kartę, aby wykonać kroki wstawiania kodu dla elementów Runbook, zasobów globalnych i działań:

Wstawianie kodu do elementu Runbook

Wykonaj następujące kroki, aby wstawić kod do elementu Runbook:

1. Otwórz element Runbook w edytorze portalu zarządzania.

2. W dolnej części ekranu wybierz pozycję Wstaw , a następnie wybierz pozycję Runbook.

3. Wybierz element Runbook do wstawienia z kolumny środkowej i wybierz strzałkę w prawo.

4. Jeśli element Runbook ma parametry, zostaną one wyświetlone dla Twoich informacji.

5. Wybierz przycisk wyboru.

6. Kod do uruchomienia wybranego elementu Runbook zostanie wstawiony do bieżącego elementu Runbook.

7. Jeśli element Runbook wymaga parametrów, podaj odpowiednią wartość zamiast typu danych otoczonego nawiasami klamrowymi <>.

Wstawianie elementu zawartości globalnej do elementu Runbook

Wykonaj następujące kroki, aby wstawić globalny zasób do elementu Runbook:

1. Otwórz element Runbook w edytorze portalu zarządzania.

2. W dolnej części ekranu wybierz pozycję Wstaw , a następnie wybierz pozycję Ustawienie.

3. W kolumnie Akcja ustawienia wybierz wymagany typ kodu.

4. Wybierz z dostępnych zasobów w środkowej kolumnie.

5. Wybierz przycisk wyboru.

Wstawianie działania do elementu Runbook

Wykonaj następujące kroki, aby wstawić działanie do elementu Runbook:

1. Otwórz element Runbook w edytorze portalu zarządzania.

2. W dolnej części ekranu wybierz pozycję Wstaw , a następnie wybierz pozycję Działanie.

3. W kolumnie Moduł integracji wybierz moduł zawierający działanie.

4. W okienku Działanie wybierz działanie.

5. W kolumnie Opis zanotuj opis działania. Opcjonalnie możesz wybrać pozycję Wyświetl szczegółową pomoc , aby uruchomić pomoc dotyczącą działania w przeglądarce.

6. Wybierz strzałkę w prawo.

7. Jeśli działanie ma parametry, zostaną one wyświetlone dla Twoich informacji.

8. Wybierz przycisk wyboru.

9. Kod do uruchomienia działania zostanie wstawiony do elementu Runbook.

10. Jeśli działanie wymaga parametrów, podaj odpowiednią wartość zamiast typu danych otoczonego nawiasami klamrowymi <>.

Edytowanie elementu Runbook automatyzacji przy użyciu programu PowerShell

Aby edytować element Runbook przy użyciu programu Windows PowerShell, należy edytować przepływ pracy przy użyciu wybranego edytora i zapisać go w pliku ps1. Możesz użyć polecenia cmdlet Get-SMARunbookDefinition , aby pobrać zawartość elementu Runbook, a następnie polecenie cmdlet Edit-SMARunbook , aby zastąpić istniejący roboczy przepływ pracy zmodyfikowanym.

Aby pobrać zawartość elementu Runbook przy użyciu programu Windows PowerShell

Poniższe przykładowe polecenia pokazują, jak pobrać skrypt dla elementu Runbook i zapisać go w pliku skryptu. W tym przykładzie pobierana jest wersja robocza. Można również pobrać opublikowaną wersję elementu Runbook, chociaż nie można zmienić tej wersji.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

$runbookDefinition = Get-SMARunbookDefinition -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Type Draft
$runbookContent = $runbookDefinition.Content

Out-File -InputObject $runbookContent -FilePath $scriptPath

Aby zmienić zawartość elementu Runbook przy użyciu programu Windows PowerShell

Poniższe przykładowe polecenia pokazują, jak zastąpić istniejącą zawartość elementu Runbook zawartością pliku skryptu zawierającego przepływ pracy.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scriptPath = "c:\runbooks\Test-Runbook.ps1"

Edit-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Path $scriptPath -Overwrite
Publish-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Path $scriptPath

Edytowanie elementu Runbook automatyzacji przy użyciu środowiska PowerShell ISE

Zintegrowane środowisko skryptów programu Windows PowerShell (ISE) to aplikacja, która umożliwia uruchamianie poleceń i pisanie, testowanie i debugowanie skryptów. Dodatek SMA PowerShell ISE umożliwia używanie tego narzędzia do pisania i testowania elementów Runbook automatyzacji.

1. Otwórz aplikację Windows PowerShell ISE.

2. Jeśli dodatek SMA ISE nie jest wyświetlany po prawej stronie środowiska ISE, otwórz menu Dodatki i włącz dodatek SMA ISE.

3. Zaloguj się do programu SMA na karcie Konfiguracja .

4. Wybierz kartę Element Runbook . Powinna zostać wyświetlona lista elementów Runbook SMA.

5. Wybierz element Runbook, który chcesz edytować, a następnie wybierz pozycję Pobierz. Spowoduje to pobranie lokalnej kopii elementu Runbook z programu SMA.

6. Wybierz Otwórz. Spowoduje to utworzenie nowej karty z elementem Runbook.

7. Wprowadź niezbędne zmiany w elementach Runbook.

8. Wybierz pozycję Przekaż wersję roboczą , aby wysłać element Runbook do programu SMA. Spowoduje to zastąpienie istniejącej wersji roboczej elementu Runbook.

9. Wybierz pozycję Publikuj wersję roboczą , jeśli chcesz opublikować najnowszą wersję roboczą elementu Runbook.

Publikowanie elementu Runbook

Po utworzeniu elementu Runbook należy go opublikować, aby proces roboczy elementu Runbook mógł go wykonać. Każdy element Runbook w usłudze Service Management Automation ma wersję roboczą i opublikowaną. Tylko wersję opublikowaną można uruchomić i tylko wersję roboczą można edytować. Na wersję opublikowaną nie mają wpływu żadne zmiany wprowadzone w wersji roboczej. Gdy wszystko będzie gotowe do udostępnienia wersji roboczej, opublikujesz ją, co spowoduje zastąpienie wersji opublikowanej wersją roboczą.

Publikowanie elementu Runbook przy użyciu portalu zarządzania

1. Wybierz obszar roboczy automatyzacji.

2. W górnej części ekranu wybierz pozycję Elementy Runbook.

3. Znajdź element Runbook do edycji i kliknij jego nazwę.

4. W górnej części ekranu wybierz pozycję Autor.

5. Wybierz pozycję Wersja robocza.

6. W dolnej części ekranu wybierz pozycję Publikuj.

7. Wybierz pozycję Tak , aby wyświetlić komunikat weryfikacyjny.

Publikowanie elementu Runbook przy użyciu programu PowerShell

Za pomocą elementu Publish-SmaRunbook można opublikować element Runbook za pomocą programu Windows PowerShell. Poniższe przykładowe polecenia pokazują, jak opublikować element Runbook.

$webServer = 'https://MyServer'
$port = 9090
$runbookPath = 'c:\runbooks\Sample-TestRunbook.ps1'
$runbookName = 'Test-Runbook'

Publish-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName

Publikowanie elementu Runbook przy użyciu programu PowerShell ISE

Zintegrowane środowisko skryptów programu Windows PowerShell (ISE) to aplikacja, która umożliwia uruchamianie poleceń i pisanie, testowanie i debugowanie skryptów. Dodatek SMA PowerShell ISE umożliwia używanie tego narzędzia do pisania i testowania elementów Runbook automatyzacji.

1. Otwórz aplikację Windows PowerShell ISE.

2. Jeśli dodatek SMA ISE nie jest wyświetlany po prawej stronie środowiska ISE, otwórz menu Dodatki i włącz dodatek SMA ISE.

3. Zaloguj się do programu SMA na karcie Konfiguracja .

4. Wybierz kartę Element Runbook . Powinna zostać wyświetlona lista elementów Runbook SMA.

5. Wybierz element Runbook i wybierz pozycję Publikuj wersję roboczą , aby opublikować najnowszą wersję roboczą elementu Runbook.

Testowanie elementu Runbook

Wersję roboczą elementu Runbook można przetestować w usłudze Service Management Automation, pozostawiając opublikowaną wersję elementu Runbook bez zmian. Dzięki temu można sprawdzić, czy element Runbook działa prawidłowo przed zastąpieniem opublikowanej wersji.

Po przetestowaniu elementu Runbook jest wykonywany projektowy element Runbook i wszystkie wykonywane przez niego akcje zostaną ukończone. Historia zadań nie jest tworzona, ale strumienie danych wyjściowych i ostrzegawczych i błędów są wyświetlane w okienku danych wyjściowych testu. Komunikaty do pełnej strumienia są wyświetlane w okienku danych wyjściowych tylko wtedy, gdy zmienna $VerbosePreference jest ustawiona na Kontynuuj.

Podczas testowania elementu Runbook nadal wykonuje on przepływ pracy normalnie i wykonuje wszelkie akcje względem zasobów w środowisku. Z tego powodu należy testować tylko elementy Runbook względem zasobów nieprodukcyjnych.

Testowanie elementu Runbook w programie Service Management Automation

Aby przetestować element Runbook, otwórz wersję roboczą elementu Runbook w portalu zarządzania. Wybierz przycisk Testuj w dolnej części ekranu, aby rozpocząć test.

Element Runbook można zatrzymać lub zawiesić podczas testowania za pomocą przycisków poniżej okienka danych wyjściowych. Gdy element Runbook zostanie wstrzymany, przed jego wstrzymaniem zostanie ukończone bieżące działanie. Po wstrzymaniu elementu Runbook można go zatrzymać lub uruchomić ponownie.

Testowanie elementu Runbook przy użyciu programu PowerShell ISE

Dodatek PROGRAMU PowerShell ISE udostępnia polecenia cmdlet, które emulują standardowe działania, takie jak Get-SMACredential i Set-SMAVariable, dzięki czemu można przetestować element Runbook na komputerze lokalnym tak samo jak każdy inny skrypt.

Zasoby globalne i ich wartości są pobierane z grupy automatyzacji do użycia na potrzeby testowania lokalnego. Możesz sprawdzić lub zmienić te wartości na karcie Zasoby . Zaszyfrowane wartości są wyświetlane w kolorze pomarańczowym, a ich wartości nie są pobierane. Jeśli chcesz używać tych zasobów w testach lokalnych, musisz ustawić ich wartość lokalnie.

Aby przetestować element Runbook w programie SMA, wybierz pozycję Test Draft in SMA (Testowanie wersji roboczej w programie SMA). Zostanie otwarte nowe okno. Wybierz pozycję Rozpocznij nowe zadanie , aby rozpocząć test. Dane wyjściowe zostaną wyświetlone w oknie.

Przykłady elementów Runbook usługi Automation

Następujące elementy Runbook są dostarczane z usługą Service Management Automation jako przykładowymi elementami Runbook, aby zilustrować techniki i najlepsze rozwiązania. Są one dostępne do użycia w rozszerzeniu automatyzacji w pakiecie Microsoft Azure Pack dla systemu Windows Server.

Nazwa elementu Runbook	opis
Przykładowe usuwanie maszyny wirtualnejskrypcyjnej w chmurze	Przedstawia przydatny scenariusz wyzwalania elementu Runbook, gdy użytkownik usunie subskrypcję chmury maszyn wirtualnych.
Przykładowe zarządzanie platformą Azure	Pokazuje, jak nawiązać połączenie z subskrypcją platformy Microsoft Azure i wykonywać podstawowe operacje przy użyciu modułu Microsoft Azure PowerShell.
Sample-Managing-ConfigurationManager	Przedstawia możliwości automatyzacji zarządzania usługami w celu nawiązania połączenia z programem Configuration Manager.
Sample-Managing-DataProtectionManager	Przedstawia sposób nawiązywania połączenia z serwerem programu Data Protection Manager (DPM) i wyświetlanie informacji o dyskach znalezionych na serwerze programu DPM.
Sample-Managing-MySQLServers	Przedstawia sposób pobierania tokenu zabezpieczającego, który będzie używany do pobierania listy serwerów hosta.
Sample-Managing-OperationsManager	Demonstruje możliwość programu Service Management Automation w celu nawiązania połączenia z programem System Center Operations Manager.
Przykładowe zarządzanie orkiestratorem	Pokazuje, jak nawiązać połączenie z programem System Center Orchestrator i uruchomić element Runbook programu Orchestrator w celu korzystania z istniejącej infrastruktury.
Przykładowe plany zarządzania	Pokazuje, jak utworzyć nowy plan i dodać usługę SQL Server ze zdefiniowanym limitem przydziału do nowego planu.
Przykładowe zarządzanie usługą ServiceBusClouds	Pokazuje, jak nawiązać połączenie z serwerem usługi Service Bus w chmurze i wyświetlić informacje o utworzonych przestrzeniach nazw.
Sample-Managing-SQLServers	Pokazuje, jak utworzyć nową grupę serwerów i dodać serwer hostingu SQL.
Przykładowe konta zarządzania użytkownikami	Pokazuje, jak utworzyć użytkownika w pakiecie Microsoft Azure Pack dla systemu Windows Server, który zostanie utworzony w pakiecie Microsoft Azure Pack i pojawi się w portalu zarządzania dla rozszerzenia Użytkownicy administratorów. Jednak ten użytkownik powinien być również zintegrowany z dostawcą uwierzytelniania (na przykład AuthSite) w celu uzyskania dostępu do portalu zarządzania dla dzierżaw, który nie jest uwzględniony w tym przykładzie.
Sample-Managing-VirtualMachineManager	Przedstawia sposób nawiązywania połączenia z serwerem programu Virtual Machine Manager (VMM) i wyświetlanie informacji o licencji serwera programu VMM.
Przykładowe zarządzanie maszynami wirtualnymi w chmurze	Przedstawia sposób uzyskiwania dostępu do informacji o połączeniu z bazą danych serwera Service Provider Foundation oraz o obiektach serwera programu VMM zarządzanych przez program Service Provider Foundation.
Przykładowe zarządzanie witryną WebSiteCloud	Pokazuje, jak nawiązać połączenie z serwerem kontrolera chmur witryny sieci Web i wyświetlić informacje o wdrożonych serwerach w chmurach witryn sieci Web.
Sample-Modify-VMCloud-Subscription	Demonstruje przydatny scenariusz wyzwalania elementu Runbook, gdy dzierżawa lub administrator zawiesza lub aktywuje subskrypcję chmur maszyn wirtualnych.
Przykładowe korzystanie z działań	Demonstruje możliwości automatyzacji zarządzania usługami do korzystania z działań
Przykładowe punkty kontrolne przy użyciu	Demonstruje możliwość używania punktów kontrolnych w usłudze Service Management Automation.
Przykładowe używanie połączeń	Demonstruje możliwość automatyzacji zarządzania usługami w celu używania połączeń do łączenia się z systemami zdalnymi.
Przykładowe użycie poświadczeń	Demonstruje możliwości automatyzacji zarządzania usługami w celu używania poświadczeń i zwraca użytkownika, na którym działa element Runbook usługi Service Management Automation. Następnie łączy się z serwerem "ServerName" i zwraca użytkownika określonego przez użytkownika "SampleCredential", który uzyskuje dostęp do serwera.
Przykładowe użycie modułów	Demonstruje importowanie modułów w elementach Runbook i zwraca liczbę już zaimportowanych modułów na serwerze "ServerName". Następnie importuje moduł określony przez moduł "ModulePath" i generuje nową liczbę modułów i informacje odpowiadające nowo zaimportowanemu modułowi.
Przykład using-RunbookParameters	Pokazuje, jak używać parametrów wejściowych dla elementów Runbook, a także określać, czy parametry są wymagane, udostępniać wartości parametrów domyślnych i używać wartości parametrów w dalszej części przepływu pracy.
Przykładowe używanie elementów Runbook	Demonstruje sposób wywoływania elementu Runbook z poziomu innego elementu Runbook.
Przykład using-SuspendWorkflow	Pokazuje, jak wymusić wstrzymanie elementu Runbook. Może to być przydatne, jeśli wymagany jest krok ręczny, zanim element Runbook powinien kontynuować, na przykład otrzymanie zatwierdzenia wylogowania od określonej osoby. Po zakończeniu kroku ręcznego zawieszony element Runbook zostanie wznowiony ręcznie, aby kontynuować element Runbook.
Przykładowe używanie zmiennych	Demonstruje możliwość używania zmiennych przez usługę Service Management Automation.
Przykład using-VMCloud-Automation	Demonstruje przydatny scenariusz wyzwalania elementu Runbook na początku zdarzenia programu Service Provider Foundation.

Następne kroki

• Przeczytaj o tym, jak wywołać jeden element Runbook z innego elementu Runbook.
• Przeczytaj o sposobie pracy z modułami integracji.