Sdílet prostřednictvím

Remove-SCScript

  • Reference
Modul:
VirtualMachineManager

Odebere objekt skriptu z nástroje VMM.

Syntaxe

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) vypíše kontejner, 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 poté předá tyto výsledky rutině Format-List, aby se uživateli zobrazil název každého skriptu a jeho cesta ke sdílené složce.

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 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 Potvrdit vás vyzve k potvrzení, že chcete tyto skripty odebrat. Můžete potvrdit odstranění všech skriptů najednou nebo potvrdit odstranění každého skriptu 1 po druhém.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Script

Určuje objekt skriptu VMM.

Typ:Script
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False