Remove-SCScript
Hiermee verwijdert u een scriptobject uit VMM.
Syntax
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 wordt u gevraagd 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 (met de eigenschap MarkedForDeletion ingesteld op $True) of retourneert een foutbericht bij 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 het delen van 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 wordt verwijderd uit het bestandssysteem op de bibliotheekserver.
De parameter Bevestigen 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
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
Hiermee geeft u een VMM-scriptobject op.
Type: | Script |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |