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 namens VMHost01 ab und speichert das Objekt in der $VMHost Variable.

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

Parameter

-CommandParameters

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Executable

Gibt den Namen eines ausführbaren Programms an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LibraryResource

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

Type:CustomResource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsAccount

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

Type:RunAsAccount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptCommandSetting

Gibt ein Skriptbefehlseinstellungsobjekt an.

Type:SCScriptCommandSetting
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StandardInput

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageFileServerNode

Gibt einen Knoten in einem Dateiservercluster an.

Type:StorageFileServerNode
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSeconds

Gibt die Anzahl der Zeit in Sekunden an, die ein Prozess vor dem Timeout wartet.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHost

Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

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

Type:Host
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.