Sdílet prostřednictvím

Remove-SCVirtualDVDDrive

  • Reference
Modul:
VirtualMachineManager

Odebere objekt virtuální jednotky DVD z nástroje VMM.

Syntaxe

Remove-SCVirtualDVDDrive
      [-VirtualDVDDrive] <VirtualDVDDrive>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualDVDDrive
      -SourceBus <Byte>
      -SourceLUN <Byte>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

Rutina Remove-SCVirtualDVDDrive odebere jeden nebo více objektů jednotky DVD z hardwarového profilu, virtuálního počítače nebo šablony virtuálního počítače použité v prostředí nástroje Virtual Machine Manager (VMM). Rutina také odstraní všechny .iso soubory, které virtuální jednotka DVD používá ze systému souborů na serveru knihovny.

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

Příklady

Příklad 1: Odebrání konkrétní virtuální jednotky DVD z virtuálního počítače

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží ho do proměnné $VM.

Druhý příkaz získá objekt virtuální jednotky DVD umístěný v prvním slotu sekundárního kanálu (určený -Bus 1 a -LUN 0) na sběrnici IDE na virtuálním počítači VM01 a pak uloží objekt jednotky DVD do proměnné $DVDDrive.

Poslední příkaz odebere objekt virtuálního disku DVD uložený v $DVDDrive z virtuálního počítače VM01 a odstraní všechny .iso soubory, které tato virtuální jednotka DVD používá ze systému souborů na serveru knihovny.

Příklad 2: Odebrání třetí virtuální jednotky DVD z virtuálního počítače

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive

První příkaz získá objekt virtuálního počítače s názvem VM02 a uloží ho do proměnné $VM.

Druhý příkaz získá všechny objekty virtuální jednotky DVD připojené k virtuálnímu počítači VM02 a uloží každý objekt jednotky DVD do pole objektů $DVDDrive. Tento příklad předpokládá, že VM02 má tři virtuální jednotky DVD, a proto pole obsahuje tři prvky (počítá se 0 až 2).

Poslední příkaz předá třetí virtuální jednotku DVD (objekt [2]) uloženou v $DVDDrive do rutiny Remove-SCVirtualDVDDrive, která odebere tento virtuální objekt jednotky DVD z virtuálního počítače VM02 a odstraní všechny .iso soubory používané touto virtuální jednotkou DVD ze systému souborů na serveru knihovny.

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

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
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

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

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

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
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

-SourceBus

Určuje zdrojovou sběrnici IDE jednotky.

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

-SourceLUN

Určuje číslo zdrojové logické jednotky (LUN) pro objekt virtuální jednotky DVD ve sběrnici IDE.

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

-VirtualDVDDrive

Určuje objekt virtuální jednotky DVD.

Typ:VirtualDVDDrive
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

Poznámky

  • Vyžaduje objekt virtuální jednotky DVD VMM, který lze načíst pomocí rutiny Get-SCVirtualDVDDrive.