Scripted Actions sind PowerShell-Skripte, die entweder im Kontext einer Windows-VM oder eines Azure Automatisierungskontos ausgeführt werden. Scripted Actions können verwendet werden, um die Funktionalität von Nerdio Manager zu erweitern und anzupassen. Nerdio Manager stellt verschiedene vorab aufgefüllte Variablen bereit, wie z. B. $VMName, die im PowerShell-Code verwendet werden können.
Nerdio Manager enthält viele sofort einsatzfähige Scripted Actions. Darüber hinaus können Skripte von den Nerdio Manager-Administratoren erstellt und angepasst werden. Sie können in verschiedenen Phasen der Nerdio Manager-Automatisierung angewendet werden. Zum Beispiel, wenn eine virtuelle Maschine erstellt, heruntergefahren oder entfernt wird. Sie können eine Aktion nach Zeitplan oder auf Desktop-Images und mehr anwenden.
Nerdio Manager verwendet zwei Arten von Scripted Actions:
-
Windows-Skripte - Scripted Actions für Windows-Skripte
-
Azure Runbooks - Scripted Actions für Azure Runbooks
Scripted Actions dienen als Bibliothek von PowerShell-Skripten, die entweder in Azure- oder AVD-virtuellen Maschinen als enthaltener Schritt für verschiedene Aufgaben ausgeführt werden können, die von Nerdio Manager durchgeführt werden.
So erstellen Sie eine neue Scripted Action:
-
Navigieren Sie zu Endpoints > Automation > Scripted Actions.
-
Wählen Sie entweder Windows Scripts oder Azure Runbooks.
-
Wählen Sie Add scripted action.
-
Geben Sie die folgenden Informationen ein:
-
Name: Geben Sie den Namen des Skripts ein. Dieser Name wird angezeigt, wenn Sie diese Aktion aus der Liste der verfügbaren Scripted Actions auswählen.
-
Beschreibung: Geben Sie die Beschreibung des Skripts ein.
-
Tags: Wählen Sie aus der Dropdown-Liste optionale Tags für das Skript aus. Diese Tags werden für die Suche und Organisation verwendet.
-
Skriptausführungsmodus: Wählen Sie aus der Dropdown-Liste den Ausführungsmodus des Skripts aus.
Anmerkung
Dieser Parameter bestimmt, wie Nerdio Manager agiert, wenn es die skriptbasierte(n) Aktion(en) an die VM übergibt. Nerdio Manager verwendet die Azure Custom Script Extension, um die PowerShell-Befehle letztendlich auszuführen (weitere Informationen zu skriptbasierten Aktionen für Windows finden Sie unter Custom Script for Windows). Die Erweiterung muss jedes Mal installiert und entfernt werden, wenn Nerdio Manager eine Windows Scripted Action ausführt. Optional können PowerShell-Skripte kombiniert und in einem einzigen Durchlauf übergeben werden, sofern sie sich nicht gegenseitig stören, was Zeit spart.
-
Kombiniert: Markiert das Skript als eines, das sicher mit anderen Skripten kombiniert werden kann. Zum Beispiel ein Skript, das einen Registry-Wert hinzufügt.
-
Individuell: Ein eigenständiges Skript für eine Aktion, die für sich allein ausgeführt werden sollte. Zum Beispiel ein langes Skript mit häufig verwendeten Variablennamen, die mit anderen Skripten in Konflikt geraten könnten, oder ein Skript, das eine neue PowerShell-Sitzung erfordert.
-
Individuell mit Neustart: Für Windows-Skripte das Skript im eigenständigen Modus ausführen und nach Abschluss einen Neustart durchführen.
-
Ausführungs-Timeout: Geben Sie für Azure Runbooks im Modus „Individuell“ das Zeitlimit (in Minuten) für die Ausführung der Skriptaktion ein.
-
-
Cloud-PC aktivieren: Schalten Sie diese Option optional für Windows-Skripte ein, um eine Cloud-PC-Skript-Richtlinie zu erstellen.
-
Dieses Skript mit den Anmeldedaten des angemeldeten Benutzers ausführen: Wählen Sie diese Option, um das Skript mit den Anmeldedaten des Benutzers auf dem Client-Computer auszuführen. Standardmäßig wird das Skript im Systemkontext ausgeführt.
-
Skriptsignaturprüfung erzwingen: Wählen Sie diese Option, um zu erzwingen, dass das Skript von einem vertrauenswürdigen Herausgeber signiert sein muss. Standardmäßig wird keine Warnung oder Eingabeaufforderung angezeigt und das Skript wird nicht blockiert ausgeführt.
-
Skript im 64-Bit-PowerShell-Host ausführen: Wählen Sie diese Option, um das Skript in einem 64-Bit-PowerShell-Host für eine 64-Bit-Clientarchitektur auszuführen.
-
Allen Benutzern zuweisen: Wählen Sie diese Option, um das Skript allen Benutzern zuzuweisen.
-
Allen Geräten zuweisen: Wählen Sie diese Option, um das Skript allen Geräten zuzuweisen.
-
Ausgewählten Gruppen zuweisen: Wählen Sie aus der Dropdownliste die Gruppe(n) aus, der/denen dieses Skript zugewiesen werden soll.
-
Zuweisungen ausschließen: Wählen Sie aus der Dropdownliste die Gruppe(n) aus, von der/denen dieses Skript ausgeschlossen werden soll.
-
-
Skript: Geben Sie den/die auszuführenden PowerShell-Befehl(e) ein.
Anmerkung
Nerdio Manager ermöglicht es Ihnen, Variablen in die Scripted Actions der Azure Runbooks zu integrieren. Weitere Informationen finden Sie unter Scripted Actions Azure Runbooks Variables Integration.
Anmerkung
In diesem Code verwendete Cmdlets müssen auf den VMs oder im Azure Automation-Konto verfügbar sein. Wenn PowerShell-Cmdlets aus Modulen verwendet werden, die standardmäßig nicht auf den Windows-VMs oder im Azure Automation-Konto vorhanden sind, müssen die Module zuerst installiert werden.
Nerdio stellt mehrere vorab ausgefüllte Variablen bereit, die im Skriptcode verwendet werden können. Die verfügbaren Variablen sind:
-
$HostPoolId (verfügbar, wenn das Skript einem Hostpool zugeordnet ist)
-
$HostPoolName (verfügbar, wenn das Skript einem Hostpool zugeordnet ist)
-
$AzureSubscriptionId
-
$AzureSubscriptionName
-
$AzureResourceGroupName
-
$AzureRegionName
-
$AzureVMName (verfügbar, wenn das Skript einer VM zugeordnet ist)
-
$ADUsername (bei Übergabe von AD-Anmeldeinformationen)
-
$ADPassword (bei Übergabe von AD-Anmeldeinformationen)
-
$DesktopUser (verfügbar, wenn das Skript einem persönlichen Hostpool zugeordnet ist)
Tipp
Wir empfehlen, dass Sie Code mit einer IDE wie VSCode oder ISE entwickeln und den PowerShell-Code anschließend auf einem dedizierten Entwicklungs-Sitzungshost/einer dedizierten Azure-VM testen.
-
-
-
Sobald Sie alle gewünschten Informationen eingegeben haben, wählen Sie Speichern und schließen.
Nerdio Manager ermöglicht es Ihnen, vorhandene Scripted Actions anzuzeigen oder zu bearbeiten.
So zeigen Sie eine vorhandene Scripted Action an und bearbeiten Sie sie:
-
Navigieren Sie zu Endpoints > Automation > Scripted Actions.
-
Wählen Sie entweder Windows-Skripte oder Azure Runbooks.
-
Finden Sie die Scripted Action, mit der Sie arbeiten möchten, und wählen Sie Bearbeiten aus.
-
Nehmen Sie bei Bedarf die erforderlichen Änderungen vor und wählen Sie Speichern und schließen aus.
Nerdio Manager ermöglicht Ihnen das Klonen einer Scripted Action.
So klonen Sie eine Scripted Action:
-
Navigieren Sie zu Endpoints > Automation > Scripted Actions.
-
Wählen Sie entweder Windows-Skripte oder Azure Runbooks.
-
Finden Sie die Scripted Action, die Sie klonen möchten, und wählen Sie im Aktionsmenü Klonen aus.
-
Nehmen Sie alle erforderlichen Änderungen vor und wählen Sie Klonen aus.
Scripted Actions Groups ermöglichen es Administratoren, Skriptsammlungen zu erstellen und diese während Standard-Bereitstellungsaufgaben zuzuweisen. Weitere Informationen finden Sie unter Scripted Actions Groups.
Scripted Actions können als Teil dieser Aufgaben verwendet werden:
-
VM-Lebenszyklusereignisse: Wird während der Bereitstellung oder dem Re-Imaging von Sitzungshost-VMs oder beim Stoppen/Starten einer VM ausgeführt. Wann immer ein Sitzungshost erstellt, gelöscht, gestoppt oder gestartet wird, wird die Scripted Action als letzter Schritt ausgeführt. Weitere Informationen zum Re-Imaging der Hosts finden Sie unter Resize/Re-image a Hostpool.
-
Skript ausführen: Führen Sie manuell einen Befehl für einen Hostpool aus. Dies ist nützlich, wenn Sie alle Session-Hosts ändern müssen, ohne sie vollständig neu zu erstellen (zum Beispiel ein Skript zum Ändern eines Registrierungsschlüssels). Weitere Informationen finden Sie unter Run Bulk Host Scripted Actions.
So wenden Sie eine konfigurierte Scripted Action auf AVD-Host-VM-Lebenszyklusereignisse an:
-
Finden Sie den Hostpool, mit dem Sie arbeiten möchten.
-
Wählen Sie im Aktionsmenü Einstellungen und dann Scripted Actions aus.
-
Schalten Sie die gewünschten Optionen für Scripted Actions ausführen, wenn ... ein.
Die Option für den Zeitpunkt der VM-Erstellung verfügt über zwei separate Slots, sodass Sie die Phase auswählen können, in der Ihr Skript ausgeführt wird:
-
Diese Scripted Actions werden unmittelbar nach der VM-Erstellung ausgeführt: Die Aktionen werden ausgeführt, nachdem die VM der Domäne beigetreten ist, aber bevor der AVD-Agent registriert wurde.
-
Diese Scripted Actions werden ausgeführt, nachdem die VM dem AVD-Hostpool beigetreten ist: Die Aktionen werden ausgeführt, nachdem die VM dem AVD-Hostpool beigetreten ist, aber bevor der Host für User verfügbar ist.
Wählen Sie den Slot aus, der dem Status entspricht, in dem sich die VM befinden muss, wenn Ihr Skript ausgeführt wird.
-
-
Geben Sie für jede Option die folgenden Informationen ein:
-
Skript: Wählen Sie aus der Dropdown-Liste das auszuführende Skript aus.
-
Eingabeparameter für skriptbasierte Aktionen: Geben Sie bei Bedarf die erforderlichen Parameter an.
-
AD-Anmeldeinformationen übergeben: Wählen Sie diese Option, um AD-Anmeldeinformationen als Variablen an das Skript zu übergeben.
-
AD-Anmeldeinformationen: Wählen Sie aus der Dropdown-Liste die zu übergebenden AD-Anmeldeinformationen aus.
-
-
Sobald Sie alle gewünschten Informationen eingegeben haben, wählen Sie Speichern und schließen.
Die Scripted Actions werden der Liste der Scripted Actions für diesen Hostpool hinzugefügt.
Warnung
Bei einigen Automatisierungen müssen die erforderlichen Aktionen im Kontext von Azure außerhalb der VM selbst durchgeführt werden. Obwohl diese Befehle auf der Sitzungshost-VM mit installiertem Azure PowerShell-Modul ausgeführt werden könnten, ist das Ausführen von Skripten auf Sitzungshosts, die auf Azure abzielen, weniger effizient und kann unzuverlässig sein. Azure Automation ermöglicht eine konsistente Ausführung und erlaubt es Nerdio Manager, die Skripte eigenständig auszuführen. Einige Skripte erfordern sogar, dass die VM neu gestartet oder heruntergefahren wird, was bedeutet, dass sie ohnehin nicht auf der Sitzungshost-VM ausgeführt werden könnten.
Informationen zur Fehlerbehebung bei Azure-Skripten finden Sie unter Troubleshoot Scripts.
So führen Sie eine Scripted Action auf dem Hostpool mithilfe der Option „Skript ausführen“ aus:
-
Finden Sie den Hostpool, mit dem Sie arbeiten möchten.
-
Wählen Sie im Aktionsmenü Hosts > Skript ausführen.
-
Geben Sie die folgenden Informationen ein:
-
Führen Sie die folgenden Scripted Actions auf allen VMs in ... aus: Wählen Sie aus der Dropdown-Liste die Scripted Actions aus, die Sie anwenden möchten.
-
Eingabeparameter für Scripted Actions: Geben Sie bei Bedarf die erforderlichen Parameter an.
-
AD-Anmeldeinformationen übergeben: Wählen Sie diese Option, um AD-Anmeldeinformationen zu übergeben.
-
AD-Anmeldeinformationen: Wählen Sie aus der Dropdown-Liste die zu übergebenden AD-Anmeldeinformationen aus.
-
VMs nach Scripted Action neu starten: Wählen Sie diese Option, um die VMs nach der Skriptausführung neu zu starten. Es ist vorzuziehen, diese Option zu verwenden, anstatt PowerShell-Neustartbefehle zu nutzen, da die Custom Script-Erweiterung fehlschlägt, wenn das Skript den Computer neu startet.
-
Hosts in Gruppen von verarbeiten: Geben Sie die Anzahl der gleichzeitigen Aktionen ein, die während dieses Massenvorgangs ausgeführt werden sollen.
-
Anzahl der Fehler vor dem Abbruch: Geben Sie die Anzahl der Fehler ein, die dazu führen, dass der Prozess beendet wird.
-
Zeitplan: Aktivieren Sie den Zeitplan und geben Sie die Zeitplaninformationen ein, um die Ausführung des Skripts gemäß einem Zeitplan zu ermöglichen.
-
Messaging: Aktivieren Sie das Messaging, um Nachrichten an aktive User zu senden.
-
Verzögerung: Wählen Sie aus der Dropdown-Liste die Anzahl der Minuten aus, die nach dem Senden der Nachricht gewartet werden soll, bevor die Verarbeitung gestartet wird.
-
Nachricht: Geben Sie die Nachricht ein, die Sie an die Benutzer senden möchten.
-
-
-
Sobald Sie alle gewünschten Informationen eingegeben haben, wählen Sie Speichern und schließen.
Verwandte Themen
Hostpool-Größe anpassen/Hostpool-Image neu erstellen
Scripted Actions für Hostpools ausführen
Scripted Actions für Windows-Skripte
Kommentare (0 Kommentare)