Freigeben über

Set-SCScriptCommand

Modul:
VirtualMachineManager Module

Konfiguriert einen Skriptbefehl.

Syntax

Default (Standardwert) 

Set-SCScriptCommand
    [-ScriptCommand] <SCScriptCommand>
    [-Executable <String>]
    [-CommandParameters <String>]
    [-ScriptCommandSetting <SCScriptCommandSetting>]
    [-ScriptType <ScriptCommandType>]
    [-TimeoutSeconds <Int32>]
    [-StandardInput <String>]
    [-LibraryResource <CustomResource>]
    [-RunAsAccount <VMMCredential>]
    [-JobGroup <Guid>]
    [-DeploymentOrder <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Set-SCScriptCommand wird ein Skriptbefehl konfiguriert.

Beispiele

Beispiel 1: Hinzufügen einer benutzerdefinierten Ressource zu einem Skriptbefehl

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PreInstall"}
PS C:\> $Resource = Get-SCCustomResource -Name "CustomResource.cr"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -LibraryResource $Resource

Der erste Befehl ruft das Anwendungsprofilobjekt mit dem Namen SvcWebAppProfile01 ab und speichert das Objekt in der Variablen $AppProfile.

Der zweite Befehl ruft das Skriptbefehlsobjekt mit dem Namen PreInstall ab und speichert das Objekt in der Variablen $ScriptCommand.

Der dritte Befehl ruft das Ressourcenobjekt mit dem Namen CustomResource ab und speichert das Objekt in der Variablen $Resource.

Mit dem letzten Befehl wird das in $Resource gespeicherte Ressourcenobjekt zu dem in $ScriptCommand gespeicherten Skriptbefehlsobjekt hinzugefügt.

Parameter

-CommandParameters

Gibt die Parameter für ein Skript oder ein ausführbares Programm an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeploymentOrder

Gibt die Reihenfolge an, in der eine Computerebene, ein Anwendungshost oder eine Anwendung bereitgestellt wird.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Executable

Gibt den Namen eines ausführbaren Programms an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz ausgeführt werden, kurz bevor der letzte Befehl ausgeführt wird, der denselben Auftragsgruppenbezeichner enthält.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LibraryResource

Gibt eine Ressource an, die in der VMM-Bibliothek gespeichert ist.

Parametereigenschaften

Typ:CustomResource
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsAccount

Gibt ein ausführendes Konto an, das Anmeldeinformationen mit der Berechtigung zum Ausführen dieser Aktion enthält.

Parametereigenschaften

Typ:VMMCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptCommand

Gibt ein Skriptbefehlsobjekt an.

Parametereigenschaften

Typ:SCScriptCommand
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptCommandSetting

Gibt ein Objekt zum Festlegen eines Skriptbefehls an.

Parametereigenschaften

Typ:SCScriptCommandSetting
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptType

Gibt einen Skripttyp an. Die zulässigen Werte für diesen Parameter sind:

  • Preinstall
  • Nach der Installation
  • SaveState (Speichern)
  • Zustand wiederherstellen
  • Vor dem Service
  • PostService
  • Vor der Deinstallation
  • Nach der Deinstallation

Parametereigenschaften

Typ:ScriptCommandType
Standardwert:None
Zulässige Werte:PreService, PostService, SaveState, RestoreState, PreInstall, PostInstall, PreUninstall, PostUninstall, OrderedCommand, BareMetalPostWinPERegistration, OnProvisionFirst, OnProvisionRest, OnDeleteLast, OnDeleteRest, Install, BareMetalPostConfiguration, BareMetalPostUnattend
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StandardInput

Gibt einen Pfad zu einer Datei an, die Standardeingabeinformationen enthält, die mit dem Skriptbefehl verwendet werden sollen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TimeoutSeconds

Gibt die Zeitspanne in Sekunden an, die ein Prozess wartet, bevor eine Zeitüberschreitung auftritt.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

ScriptCommand

Dieses Cmdlet gibt ein ScriptCommand-Objekt zurück.