Udostępnij za pośrednictwem

Edytowanie tekstowych elementów Runbook w usłudze Azure Automation

  • Artykuł

Edytor tekstu w usłudze Azure Automation umożliwia edytowanie elementów Runbook programu PowerShell i elementów Runbook przepływu pracy programu PowerShell. Ten edytor zawiera typowe funkcje innych edytorów kodu, takich jak IntelliSense. Używa również kodowania kolorami z dodatkowymi funkcjami specjalnymi, aby ułatwić uzyskiwanie dostępu do zasobów wspólnych dla elementów Runbook.

Edytor tekstowy zawiera funkcję wstawiania kodu poleceń cmdlet, zasobów i podrzędnych elementów runbook do elementu Runbook. Zamiast wpisywać kod samodzielnie, możesz wybrać z listy dostępnych zasobów, a edytor wstawia odpowiedni kod do elementu Runbook.

Każdy element Runbook w usłudze Azure Automation ma dwie wersje: Wersja robocza i Opublikowana. Edytujesz wersję roboczą elementu Runbook, a następnie opublikujesz go, aby można było go wykonać. Nie można edytować wersji opublikowanej. Aby uzyskać więcej informacji, zobacz Publikowanie elementu Runbook.

Ten artykuł zawiera szczegółowe kroki wykonywania różnych funkcji w tym edytorze. Nie mają one zastosowania do graficznych elementów Runbook. Aby pracować z tymi elementami Runbook, zobacz Graficzne tworzenie w usłudze Azure Automation.

Ważne

Nie dołączaj słowa kluczowego "AzureRm" do żadnego skryptu przeznaczonego do wykonania za pomocą modułu Az. Dołączenie słowa kluczowego, nawet w komentarzu, może spowodować załadowanie modułu AzureRm, a następnie konflikt z modułem Az.

Edytowanie elementu Runbook za pomocą witryny Azure Portal

  1. W witrynie Azure Portal wybierz swoje konto usługi Automation.
  2. W obszarze AUTOMATYZACJA PROCESU wybierz pozycję Elementy Runbook , aby otworzyć listę elementów Runbook.
  3. Wybierz element Runbook do edycji, a następnie kliknij przycisk Edytuj.
  4. Edytuj element Runbook.
  5. Po zakończeniu edycji kliknij przycisk Zapisz .
  6. Kliknij pozycję Publikuj , jeśli chcesz opublikować najnowszą wersję roboczą elementu Runbook.

Wstawianie polecenia cmdlet do elementu Runbook

  1. Na kanwie edytora tekstowego umieść kursor, w którym chcesz umieścić polecenie cmdlet.
  2. Rozwiń węzeł Polecenia cmdlet w kontrolce Biblioteka.
  3. Rozwiń moduł zawierający polecenie cmdlet do użycia.
  4. Kliknij prawym przyciskiem myszy nazwę polecenia cmdlet, aby wstawić i wybrać polecenie Dodaj do kanwy. Jeśli polecenie cmdlet ma więcej niż jeden zestaw parametrów, edytor dodaje zestaw domyślny. Możesz również rozwinąć polecenie cmdlet, aby wybrać inny zestaw parametrów.
  5. Należy pamiętać, że kod polecenia cmdlet jest wstawiany z całą listą parametrów.
  6. Podaj odpowiednią wartość zamiast wartości otoczonej nawiasami kątowymi (<>) dla wszystkich wymaganych parametrów. Usuń wszystkie parametry, których nie potrzebujesz.

Wstawianie kodu podrzędnego elementu Runbook do elementu Runbook

  1. Na kanwie edytora tekstowego umieść kursor, w którym chcesz umieścić kod podrzędnego elementu Runbook.
  2. Rozwiń węzeł Elementy Runbook w kontrolce Biblioteka.
  3. Kliknij prawym przyciskiem myszy element Runbook, aby wstawić i wybrać polecenie Dodaj do kanwy.
  4. Kod podrzędnego elementu Runbook jest wstawiany z dowolnymi symbolami zastępczymi dla dowolnych parametrów elementu Runbook.
  5. Zastąp symbole zastępcze odpowiednimi wartościami dla każdego parametru.

Wstawianie elementu zawartości do elementu Runbook

  1. W kontrolce Kanwa edytora tekstowego umieść kursor, w którym chcesz umieścić kod podrzędnego elementu Runbook.
  2. Rozwiń węzeł Zasoby w kontrolce Biblioteka.
  3. Rozwiń węzeł dla żądanego typu zasobu.
  4. Kliknij prawym przyciskiem myszy nazwę zasobu, aby wstawić i wybrać polecenie Dodaj do kanwy. W przypadku zasobów zmiennych wybierz pozycję Dodaj "Pobierz zmienną" do kanwy lub Dodaj "Ustaw zmienną" na kanwę, w zależności od tego, czy chcesz uzyskać, czy ustawić zmienną.
  5. Należy pamiętać, że kod zasobu jest wstawiany do elementu Runbook.

Edytowanie elementu Runbook usługi Azure Automation przy użyciu programu Windows PowerShell

Aby edytować element Runbook przy użyciu programu Windows PowerShell, użyj wybranego edytora i zapisz element Runbook w pliku ps1 . Aby pobrać zawartość elementu Runbook, możesz użyć polecenia cmdlet Export-AzAutomationRunbook . Możesz użyć polecenia cmdlet Import-AzAutomationRunbook , aby zastąpić istniejący roboczy element Runbook zmodyfikowanym elementem .

Pobieranie zawartości 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.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Export-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -OutputFolder $scriptFolder -Slot Draft

Zmienianie zawartości 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.

$resourceGroupName = "MyResourceGroup"
$automationAccountName = "MyAutomatonAccount"
$runbookName = "Hello-World"
$scriptFolder = "c:\runbooks"

Import-AzAutomationRunbook -Path "$scriptfolder\Hello-World.ps1" -Name $runbookName -Type PowerShell -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName -Force
Publish-AzAutomationRunbook -Name $runbookName -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

Następne kroki