Delen via


Remove-SCScript

Hiermee verwijdert u een scriptobject uit VMM.

Syntaxis

Default (Standaard)

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

Description

Met de cmdlet Remove-SCScript worden een of meer scriptobjecten uit de VMM-bibliotheek verwijderd en wordt het bijbehorende scriptbestand op de bibliotheekserver verwijderd.

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

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

Deze cmdlet retourneert het object als het object is gelukt (met de eigenschap MarkedForDeletion ingesteld op $True) of retourneert een foutbericht als het mislukt.

Voorbeelden

Voorbeeld 1: Verwijder een scriptobject en verwijder het bijbehorende scriptbestand

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 kan meer dan één bestand met dezelfde naam bestaan als er meer dan één container voor scripts bestaat op de opgegeven bibliotheekserver.

De tweede opdracht telt het aantal scripts in $Scrips en geeft de resultaten weer aan de gebruiker.

De derde opdracht geeft elk scriptobject in $Scripts door aan de Select-Object cmdlet, die de naam en het share-pad voor elk script in de matrix selecteert. 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.

Met de laatste opdracht verwijdert u het eerste object in de matrix $Scripts en wordt de parameter Force gebruikt 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.

De tweede opdracht geeft elk scriptobject in $Scripts door aan Remove-SCScript, waardoor elk scriptobject uit de bibliotheek wordt verwijderd en elk corresponderend scriptbestand uit het bestandssysteem op de bibliotheekserver wordt verwijderd.

Met de parameter Confirm wordt u gevraagd te bevestigen dat u deze scripts wilt verwijderen. U hebt de mogelijkheid om de verwijdering van alle scripts in één keer te bevestigen of om de verwijdering van elk script één voor één te bevestigen.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Guid
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RunAsynchronously

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Script

Hiermee geeft u een VMM-scriptobject op.

Parametereigenschappen

Type:Script
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.