Sdílet prostřednictvím


Remove-SCScript

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 obsahujícího skript a vyzve vás 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í OznačenoForDeletion 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. Více než jeden soubor se stejným názvem může existovat, pokud na zadaném serveru knihovny existuje více než jeden kontejner pro skripty.

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 předá tyto výsledky 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 použije parametr Force k zajištění 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 obsahují řetězec Sysprep z VMMServer01 a pak tyto objekty uloží do pole pojmenované $Scripts.

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

Potvrzení parametru vás vyzve k potvrzení, že chcete tyto skripty odebrat. Můžete potvrdit odstranění všech skriptů najednou nebo potvrdit odstranění jednotlivých skriptů.

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 nutnosti požádat 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 se spouští asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

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