Freigeben über

Invoke-SCScriptCommand

  • Referenz
Modul:
VirtualMachineManager

Führt einen Skriptbefehl auf dem angegebenen Host aus.

Syntax

Invoke-SCScriptCommand
      -VMHost <Host>
      -Executable <String>
      [-CommandParameters <String>]
      [-ScriptCommandSetting <SCScriptCommandSetting>]
      [-TimeoutSeconds <Int32>]
      [-StandardInput <String>]
      [-LibraryResource <CustomResource>]
      [-RunAsAccount <RunAsAccount>]
      [-VMMServer <ServerConnection>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [<CommonParameters>]
Invoke-SCScriptCommand
      -StorageFileServerNode <StorageFileServerNode>
      -Executable <String>
      [-CommandParameters <String>]
      [-ScriptCommandSetting <SCScriptCommandSetting>]
      [-TimeoutSeconds <Int32>]
      [-StandardInput <String>]
      [-LibraryResource <CustomResource>]
      [-RunAsAccount <RunAsAccount>]
      [-VMMServer <ServerConnection>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [<CommonParameters>]

Beschreibung

Das cmdlet Invoke-SCScriptCommand führt einen Skriptbefehl auf dem angegebenen Host aus. Dieses Cmdlet wird nur auf Hyper-V Hosts unterstützt.

Beispiele

Beispiel 1: Ausführen eines Skriptbefehls

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Invoke-SCScriptCommand -VMHost $VMHost -Executable "cmd.exe" -CommandParameters "/C rd C:\test" -TimeoutSeconds 60

Der erste Befehl ruft das Hostobjekt "VMHost01" ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl führt das ausführbare Programm mit dem Namen cmd.exe mit den angegebenen Parametern auf dem host aus, der in $VMHost gespeichert ist. In diesem Fall entfernt Invoke-SCScriptCommand das Testverzeichnis aus dem Laufwerk c: auf VMHost01.

Parameter

-CommandParameters

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Executable

Gibt den Namen eines ausführbaren Programms an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LibraryResource

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

Typ:CustomResource
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsAccount

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

Typ:RunAsAccount
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptCommandSetting

Gibt ein Skriptbefehlseinstellungsobjekt an.

Typ:SCScriptCommandSetting
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StandardInput

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageFileServerNode

Gibt einen Knoten in einem Dateiservercluster an.

Typ:StorageFileServerNode
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeoutSeconds

Gibt die Zeitdauer in Sekunden an, die ein Prozess wartet, bevor ein Zeitlimit abläuft.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMHost

Gibt ein Hostobjekt eines virtuellen Computers an. VMM unterstützt Hyper-V Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im cmdlet Add-SCVMHost.

Typ:Host
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

ScriptCommand

Dieses Cmdlet gibt ein ScriptCommand--Objekt zurück.

Hinweise

  • Erfordert ein VMHost--Objekt, das mithilfe des Cmdlets Get-SCVMHost abgerufen werden kann.