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.