Freigeben über

Remove-SCScript

  • Referenz
Modul:
VirtualMachineManager

Entfernt ein Skriptobjekt aus VMM.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCScript entfernt mindestens ein Skriptobjekt aus der VMM-Bibliothek und löscht die entsprechende Skriptdatei auf dem Bibliotheksserver.

Wenn das Skript an ein Vorlagen- oder Hardwareprofil angefügt ist (und wenn 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 ja antworten, entfernt VMM die Zuordnung zwischen dem Skript und dem Container, dem er angefügt ist, und löscht dann das Skriptobjekt aus VMM.
  • Wenn Sie nein antworten, wird der Vorgang abgebrochen.

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der Eigenschaft "MarkedForDeletion" auf $True festgelegt) zurück oder gibt eine Fehlermeldung zurück.

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

Der erste Befehl ruft das Skriptobjekt namens AddHost.ps1 aus der VMM-Bibliothek auf VMMServer01 ab und speichert das Objekt im Array namens $Scripts. Wenn auf dem angegebenen Bibliothekserver mehrere Container für Skripts vorhanden sind, sind möglicherweise mehrere Dateien mit dem gleichen Namen vorhanden.

Der zweite Befehl zählt die Anzahl der Skripts in $Scrips und zeigt die Ergebnisse dem Benutzer 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 jeden Skriptnamen und seinen Freigabepfad an den Benutzer anzuzeigen.

Der letzte Befehl löscht das erste Objekt im $Scripts Array und verwendet den Force-Parameter , um sicherzustellen, dass das Skriptobjekt aus der VMM-Datenbank entfernt wird und die entsprechende Skriptdatei aus dem Dateisystem auf dem Bibliotheksserver 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

Der erste Befehl ruft alle Skriptobjekte ab, deren Namen die Zeichenfolge "Sysprep" aus VMMServer01 enthalten und dann diese Objekte im Array namens $Scripts speichert.

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

Der Parameter " Bestätigen " fordert Sie auf, zu bestätigen, dass Sie diese Skripts entfernen möchten. Sie haben die Möglichkeit, das Löschen aller Skripts gleichzeitig zu bestätigen oder das Löschen jedes Skripts nacheinander zu bestätigen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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

-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

-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

-Script

Gibt ein VMM-Skriptobjekt an.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

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