Sdílet prostřednictvím

Remove-SCScript

  • Reference
Modul:
VirtualMachineManager

Odebere objekt skriptu z nástroje VMM.

Syntax

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

Description

Rutina Remove-SCScript odebere jeden nebo více objektů skriptu z knihovny VMM a odstraní odpovídající soubor skriptu na serveru knihovny.

Pokud je skript připojený k šabloně nebo hardwarovému profilu (a pokud nepoužíváte parametr Force ), nástroj Virtual Machine Manager (VMM) zobrazí seznam kontejneru, který obsahuje skript, a zobrazí výzvu k potvrzení, že chcete skript odebrat:

  • Pokud odpovíte Ano, nástroj VMM odebere přidružení mezi skriptem a kontejnerem, ke kterému je připojen, a pak odstraní objekt skriptu z nástroje VMM.
  • Pokud odpovíte ne, operace se zruší.

Tato rutina vrátí objekt po úspěchu (s vlastností MarkedForDeletion nastavenou na $True) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání objektu skriptu a odstranění odpovídajícího souboru skriptu

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

První příkaz získá objekt skriptu s názvem AddHost.ps1 z knihovny VMM na VMMServer01 a uloží objekt do pole s názvem $Scripts. Pokud na zadaném serveru knihovny existuje více než jeden kontejner pro skripty, může existovat více než jeden soubor se stejným názvem.

Druhý příkaz spočítá počet skriptů v $Scrips a zobrazí výsledky uživateli.

Třetí příkaz předá každý objekt skriptu v $Scripts rutině Select-Object, která vybere název a cestu ke sdílené složce pro každý skript v poli. Příkaz pak tyto výsledky předá rutině Format-List, aby se zobrazily názvy jednotlivých skriptů a jeho cesta ke sdílené složce uživateli.

Poslední příkaz odstraní první objekt v poli $Scripts a pomocí parametru Force zajistí odebrání objektu skriptu z databáze VMM a odpovídající soubor skriptu se odstraní ze systému souborů na serveru knihovny.

Příklad 2: Odebrání více skriptů z knihovny

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

První příkaz získá všechny objekty skriptu, jejichž názvy zahrnují řetězec "Sysprep" z VMMServer01 a pak uloží tyto objekty do pole s názvem $Scripts.

Druhý příkaz předá každý objekt skriptu v $Scripts remove-SCScript, který odebere každý objekt skriptu z knihovny a odstraní každý odpovídající soubor skriptu ze systému souborů na serveru knihovny.

Parametr Confirm vás vyzve k potvrzení, že chcete tyto skripty odebrat. Odstranění všech skriptů můžete potvrdit najednou nebo potvrdit odstranění jednotlivých skriptů 1:1.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Script

Určuje objekt skriptu VMM.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False