Dieser Artikel enthält detaillierte Informationen zur Verwendung, zu den unterstützten Funktionen und zu wichtigen Überlegungen zu Windows-Scripted Actions. Windows-Scripted Actions ermöglichen die Ausführung benutzerdefinierter Skripte auf Windows-basierten Systemen innerhalb der festgelegten Einschränkungen und bieten verschiedene Optionen für die Parametersteuerung.
Anmerkung
Das Modell für die Ausführung von Scripted Actions für Windows-Skripte hat sich ab v5.3 geändert. Stellen Sie daher sicher, dass zuvor verwendete Scripted Actions für Windows-Skripte weiterhin funktionsfähig sind. Diese Änderung betrifft auch die REST-API. Verwenden Sie anstelle des Felds „ScriptedActionsIds“ „ScriptedActions“, um die Liste der Scripted Actions für Windows-Skripte zu übergeben. Aus Gründen der Abwärtskompatibilität sollte das Feld „ScriptedActionsIds“ jedoch auch funktionieren, obwohl es das Übergeben von Parametern nicht unterstützt.
Für benutzerdefinierte Optionen von Windows Scripted Actions ist Support verfügbar. Damit können Sie Windows-Skripte mit spezifischen Konfigurationen ausführen. Folgende Einschränkungen und Optionen gelten derzeit:
Unterstützte Plattformen
Es werden nur Windows-Skripte unterstützt. Azure Runbooks werden nicht unterstützt.
Skriptausführungsmodus
Skripte können in den Modi „Individual“ und „Individual with Restart“ ausgeführt werden.
Benutzerdefinierte Skripte werden auf Cloud-PCs nicht unterstützt.
Windows Scripted Actions Groups
Die Verwendung von Skripten in Windows Scripted Actions Groups wird nicht unterstützt.
Windows-Skripte beinhalten beim Speichern eine grundlegende PowerShell-Codevalidierung. Dieses Feature hilft, Syntaxfehler im Skriptcode zu erkennen und potenzielle Issues zu vermeiden.
Windows Scripted Actions unterstützen eine Vielzahl von Parametertypen, von denen jeder über ein eigenes Steuerelement in der Benutzeroberfläche verfügt.
Tipp
`bool`, `switch`: Kontrollkästchen
`byte`, `sbyte`, `ushort`, `short`, `int`, `uint`, `long`, `ulong`, `float`, `double`, `decimal`: Zahleneingabe mit Wertegrenzen für jeden Typ
`char`, `string`: Texteingabe
`string[]`: Mehrfachauswahl
Sie können die folgenden Attribute in Ihren Skripten verwenden:
Tipp
`DisplayName`
`Description`
`Parameter`
`Mandatory`
`HelpMessage` (kann das Attribut „Description“ überschreiben oder von diesem überschrieben werden)
`ParameterSetName` (derzeit nur für Nerdio Manager integrierte Parameter)
`ValidateSet` (für den Typ „string“, ersetzt die Texteingabe durch eine Einzelauswahl; für „string[]“ werden die verfügbaren Optionen festgelegt)
Sie können Parameter in Ihrem Skript mithilfe der JSON-Notation definieren. Die Struktur für JSON-Parameterdefinitionen sieht wie folgt aus:
Tipp
{
"parameter_name_1": {
"DisplayName": "string",
"Description": "string",
"IsRequired": "bool",
"Type": "string",
"OptionsSet": [
Wert "Jeder Wert, der an den Skriptparameter übergeben wird" },
Wert "Anderer Wert", "Bezeichnung": "Anzeigename für diese Option, optional" }
]
},
"parameter_name_2": { ... }
}
Anmerkung
Alle Parameter sowie die JSON-Definition selbst sind optional.
Windows Scripted Actions erhalten standardmäßig die Standardvariablen. Wenn Sie jedoch benutzerdefinierte Parameter einfügen, müssen diese Variablen mithilfe von ParameterSetName definiert werden, andernfalls werden sie in die Skriptaktion aufgenommen.
Um integrierte Nerdio Manager-Parameter zu verwenden, einschließlich `$AzureRegionName` und `$AzureSubscriptionName`, können Sie wie folgt vorgehen:
-
Lassen Sie den „param“-Block weg, dann gilt das alte Verhalten, bei dem integrierte Parameter automatisch an das Skript übergeben werden.
-
Wenn Sie einen erforderlichen integrierten Parameter zum „param“-Block hinzufügen möchten, verwenden Sie den korrekten Namen (siehe QuickInfo) und den passenden Typ („string“ für die meisten Parameter, „object“ für `$SecureVars`). Legen Sie außerdem `ParameterSetName = "NME_PARAMETER"` fest.
Beispiel:
In diesem Fall ist der Parameter in der Benutzeroberfläche ausgeblendet, wird aber automatisch von Nerdio Manager an das Skript übergeben.
Tipp
param (
[Parameter(ParameterSetName="NME_PARAMETER")]
[string] $AzureRegionName
)
Prüfen Sie, ob Windows Scripted Actions in verschiedenen Szenarien ordnungsgemäß funktionieren:
-
Windows Scripted Actions auf Hosts ausführen
-
Windows Scripted Actions massenhaft auf Hosts ausführen
-
Ausschalten und als Image festlegen
-
Windows Scripted Actions auf einem Desktop-Image ausführen
-
Ein Desktop-Image aus einer Bibliothek erstellen
-
Ein Desktop-Image aus einer VM erstellen
-
Desktop-Image klonen
-
Hostpool Einstellungen > Scripted Actions
Kommentare (0 Kommentare)