Freigeben über

Set-SCPROTip

  • Referenz
Modul:
VirtualMachineManager

Legt den Status eines PRO-Tipps fest.

Syntax

Set-SCPROTip
   [-VMMServer <ServerConnection>]
   -PROTipID <String>
   [-TipStatus <String>]
   [-ActionSummary <String>]
   [-ActionDetails <String>]
   [-ActionScript <String>]
   [-ActionDetailsOpsMgrString <String[]>]
   [-ActionSummaryOpsMgrString <String[]>]
   [-LastErrorOpsMgrString <String[]>]
   [-LastError <String>]
   [-RunAsynchronously]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Set-SCPROTip-Cmdlet wird der Status eines Tippobjekts (Performance and Resource Optimization, PRO) festgelegt. Dieses Cmdlet, das von PRO-Tipp-Implementierungsaktionen aufgerufen wird und für die Erstellung von PRO Packs verwendet wird, wird von Virtual Machine Manager (VMM) verwendet, um den Status eines PRO-Tipps zu aktualisieren, während die vom PRO-Tipp empfohlene Aktion ausgeführt wird. Mit diesem Cmdlet können Sie den Status von PRO-Tipps manuell aktualisieren.

Beispiele

Beispiel 1: Festlegen des Status eines PRO-Tipps

PS C:\> $PROTips = Get-SCPROTip
PS C:\> Set-SCPROTip -PROTipID $PROTips[0].Id -TipStatus Running

Der erste Befehl ruft alle aktiven PRO-Tippobjekte aus der VMM-Datenbank ab und speichert die Objekte im $AllPROTips-Objektarray.

Der letzte Befehl aktualisiert den ersten Tipp, der in $PROTips gespeichert ist (wie durch die [0]) festgelegt, auf den Status "Ausführen".

Parameter

-ActionDetails

Enthält eine detaillierte Beschreibung der Implementierung dieses PRO-Tipps.

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

-ActionDetailsOpsMgrString

Gibt ein Array von Zeichenfolgen an, die verwendet werden, um übersetzten Aktionsdetails text bereitzustellen. Das erste Element des Arrays sollte die GUID der Operations Manager-Zeichenfolge sein, und die folgenden Elemente sollten die Parameter für die Zeichenfolgenformatierung sein.

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

-ActionScript

Gibt das Skript an, das ausgeführt wird, indem dieser PRO-Tipp implementiert wird.

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

-ActionSummary

Enthält eine zusammenfassungsbezogene Beschreibung der Implementierung dieses PRO-Tipps.

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

-ActionSummaryOpsMgrString

Gibt ein Array von Zeichenfolgen an, die verwendet werden, um übersetzten Aktionszusammenfassungstext bereitzustellen. Das erste Element des Arrays sollte die GUID der Operations Manager-Zeichenfolge sein, und die folgenden Elemente sollten die Parameter für die Zeichenfolgenformatierung sein.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
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

-LastError

Gibt den Fehlertext eines Laufzeitfehlers aus einem PRO-Tippskript an.

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

-LastErrorOpsMgrString

Gibt ein Array von Zeichenfolgen an, die verwendet werden, um übersetzten Fehlertext bereitzustellen. Das erste Element des Arrays sollte die GUID der Operations Manager-Zeichenfolge sein, und die folgenden Elemente sollten die Parameter für die Zeichenfolgenformatierung sein.

Typ:String[]
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:String
Position:Named
Standardwert:None
Erforderlich:True
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

-TipStatus

Gibt den aktuellen Status eines PRO-Tippobjekts an. Die zulässigen Werte für diesen Parameter sind:

  • Aktiv. Der Benutzer kann die empfohlene Aktion des Tipps aufrufen.
  • Initialisiert. Der Tipp wurde aufgerufen; unvollständige Aufträge werden in die Warteschlange gestellt.
  • Auto.
  • Ausgeführte. Der Tipp wurde aufgerufen; ihre Aufträge werden ausgeführt.
  • Entschlossen. Die Implementierung des Tipps wurde erfolgreich abgeschlossen.
  • Misslungen. Fehler bei der Implementierung des Tipps.
  • Entlassen. Der Benutzer hat sich entschieden, den Tipp zu ignorieren.
  • Geschlossen.
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt (Virtual Machine Manager) an.

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

Ausgaben

PROTip

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