Delen via

Remove-SCScript

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een scriptobject uit VMM.

Syntaxis

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

Description

De cmdlet Remove-SCScript verwijdert een of meer scriptobjecten uit de VMM-bibliotheek en verwijdert het bijbehorende scriptbestand op de bibliotheekserver.

Als het script is gekoppeld aan een sjabloon of hardwareprofiel (en als u de parameter Force niet gebruikt), vermeldt Virtual Machine Manager (VMM) de container die het script bevat en vraagt u om te bevestigen dat u het script wilt verwijderen:

  • Als u Ja beantwoordt, verwijdert VMM de koppeling tussen het script en de container waaraan het is gekoppeld en verwijdert het scriptobject vervolgens uit VMM.
  • Als u Nee beantwoordt, wordt de bewerking geannuleerd.

Deze cmdlet retourneert het object bij succes (waarbij de eigenschap MarkedForDeletion is ingesteld op $True) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een scriptobject verwijderen en het bijbehorende scriptbestand verwijderen

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

Met de eerste opdracht wordt het scriptobject met de naam AddHost.ps1 opgehaald uit de VMM-bibliotheek op VMMServer01 en wordt het object opgeslagen in de matrix met de naam $Scripts. Er kunnen meer dan één bestand met dezelfde naam bestaan als er meer dan één container voor scripts bestaat op de opgegeven bibliotheekserver.

Met de tweede opdracht wordt het aantal scripts in $Scrips geteld en worden de resultaten weergegeven aan de gebruiker.

Met de derde opdracht wordt elk scriptobject in $Scripts doorgegeven aan de cmdlet Select-Object, waarmee de naam en het pad voor delen voor elk script in de matrix worden geselecteerd. De opdracht geeft deze resultaten vervolgens door aan de Format-List-cmdlet om elke scriptnaam en het bijbehorende sharepad weer te geven aan de gebruiker.

De laatste opdracht verwijdert het eerste object in de $Scripts matrix en gebruikt de parameter Force om ervoor te zorgen dat het scriptobject wordt verwijderd uit de VMM-database en het bijbehorende scriptbestand wordt verwijderd uit het bestandssysteem op de bibliotheekserver.

Voorbeeld 2: Meerdere scripts uit de bibliotheek verwijderen

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

Met de eerste opdracht worden alle scriptobjecten opgehaald waarvan de namen de tekenreeks Sysprep van VMMServer01 bevatten en worden deze objecten vervolgens opgeslagen in de matrix met de naam $Scripts.

Met de tweede opdracht wordt elk scriptobject in $Scripts doorgegeven aan Remove-SCScript-, waarmee elk scriptobject uit de bibliotheek wordt verwijderd en elk bijbehorend scriptbestand uit het bestandssysteem op de bibliotheekserver wordt verwijderd.

De Bevestig parameter vraagt u om te bevestigen dat u deze scripts wilt verwijderen. U hebt de mogelijkheid om het verwijderen van alle scripts tegelijk te bevestigen of om het verwijderen van elk script één voor één te bevestigen.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Script

Hiermee geeft u een VMM-scriptobject op.

Type:Script
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False