Delen via

Remove-SCScript

  • Referentie
Module:
VirtualMachineManager

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