Freigeben über


Remove-SCScript

Entfernt ein Skriptobjekt aus VMM.

Syntax

Default (Standardwert)

Remove-SCScript
    [-Script] <Script>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCScript entfernt ein oder mehrere Skriptobjekte aus der VMM-Bibliothek und löscht die entsprechende Skriptdatei auf dem Bibliothekserver.

Wenn das Skript an eine Vorlage oder ein Hardwareprofil angefügt ist ( und Sie den Force-Parameter nicht verwenden), listet Virtual Machine Manager (VMM) den Container auf, der das Skript enthält, und fordert Sie auf, zu bestätigen, dass Sie das Skript entfernen möchten:

  • Wenn Sie mit Ja antworten, entfernt VMM die Zuordnung zwischen dem Skript und dem Container, an den es angefügt ist, und löscht dann das Skriptobjekt aus VMM.
  • Wenn Sie mit Nein antworten, wird der Vorgang abgebrochen.

Dieses Cmdlet gibt das Objekt bei Erfolg zurück (wobei die Eigenschaft MarkedForDeletion auf $True festgelegt ist) oder gibt eine Fehlermeldung zurück, wenn ein Fehler auftritt.

Beispiele

Beispiel 1: Entfernen eines Skriptobjekts und Löschen der entsprechenden Skriptdatei

PS C:\> $Scripts = @(Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1"} )
PS C:\> $Scripts.Count
PS C:\> $Scripts | select Name,SharePath | Format-List
PS C:\> Remove-SCScript -Script $Scripts[0] -Force

Mit dem ersten Befehl wird das Skriptobjekt mit dem Namen AddHost.ps1 aus der VMM-Bibliothek auf VMMServer01 abgerufen und das Objekt im Array mit dem Namen $Scripts gespeichert. Möglicherweise sind mehrere Dateien mit demselben Namen vorhanden, wenn auf dem angegebenen Bibliothekserver mehr als ein Container für Skripts vorhanden ist.

Der zweite Befehl zählt die Anzahl der Skripts in $Scrips und zeigt dem Benutzer die Ergebnisse an.

Der dritte Befehl übergibt jedes Skriptobjekt in $Scripts an das Cmdlet Select-Object, das den Namen und den Freigabepfad für jedes Skript im Array auswählt. Der Befehl übergibt diese Ergebnisse dann an das Cmdlet Format-List, um dem Benutzer jeden Skriptnamen und den zugehörigen Freigabepfad anzuzeigen.

Mit dem letzten Befehl wird das erste Objekt im $Scripts Array gelöscht und mit dem Force-Parameter sichergestellt, dass das Skriptobjekt aus der VMM-Datenbank und die entsprechende Skriptdatei aus dem Dateisystem auf dem Bibliothekserver gelöscht wird.

Beispiel 2: Entfernen mehrerer Skripts aus der Bibliothek

PS C:\> $Scripts = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Sysprep" }
PS C:\> $Scripts | Remove-SCScript -Confirm

Mit dem ersten Befehl werden alle Skriptobjekte, deren Namen die Zeichenfolge "Sysprep" enthalten, von VMMServer01 abgerufen und dann in dem Array mit dem Namen $Scripts gespeichert.

Der zweite Befehl übergibt jedes Skriptobjekt in $Scripts an Remove-SCScript, wodurch jedes Skriptobjekt aus der Bibliothek entfernt und jede entsprechende Skriptdatei aus dem Dateisystem auf dem Bibliothekserver gelöscht wird.

Der Parameter Confirm fordert Sie auf, zu bestätigen, dass Sie diese Skripts entfernen möchten. Sie haben die Möglichkeit, das Löschen aller Skripte auf einmal zu bestätigen oder das Löschen jedes Skripts einzeln zu bestätigen.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

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

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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

-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

-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

-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

-Script

Gibt ein VMM-Skriptobjekt an.

Parametereigenschaften

Typ:Script
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

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

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.