Remove-SCScript
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] -ForceDer 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 -ConfirmDer 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 |