Sdílet prostřednictvím

Remove-SCVirtualDiskDrive

  • Reference
Modul:
VirtualMachineManager

Odebere virtuální diskové jednotky z virtuálního počítače nebo ze šablony virtuálního počítače.

Syntaxe

Remove-SCVirtualDiskDrive
      [-VirtualDiskDrive] <VirtualDiskDrive>
      [-SkipDeleteVHD]
      [-JobGroup <Guid>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

Rutina Remove-SCVirtualDiskDrive odebere objekty virtuálních disků z virtuálního počítače nebo ze šablony virtuálního počítače v prostředí nástroje Virtual Machine Manager (VMM).

Příklady

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

PS C:\> $VM = Get-SCVirtualMachine | Where-Object { $_.VMHost.Name -Eq "VMHost01.Contoso.com" -And $_.Name -Eq "VM01" }
PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -VM $VM)
PS C:\> If($VirtDiskDrive.Count -Gt 1){Remove-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[1]}

První příkaz získá objekt virtuálního počítače s názvem VM01 nasazený na VMHost01 pomocí rutiny Get-SCVirtualMachine. Příkaz uloží tento objekt do proměnné $VM.

Druhý příkaz načte všechny objekty virtuálních disků na virtuálním počítači VM01 a potom uloží načtené objekty do $VirtDiskDrive. Použití symbolu @ a závorek zajistí, že příkaz uloží výsledky do pole, i když příkaz vrátí jeden objekt nebo $Null hodnotu.

Poslední příkaz vrátí početvirtuálních

Příklad 2: Odebrání všech předávacích disků připojených k virtuálnímu počítači

PS C:\> $VM = Get-SCVirtualMachine | Where-Object {$_.Name -Eq "VM02"}
PS C:\> $VirtDiskDrives = @(Get-SCVirtualDiskDrive -VM $VM | Where-Object {$_.IsVHD -Eq $False})
PS C:\> If($VirtDiskDrives.Count -Gt 0){ForEach($VirtDiskDrive in $VirtDiskDrives){Remove-SCVirtualDiskDrive -Force -VirtualDiskDrive $VirtDiskDrive}}

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

Druhý příkaz získá všechny objekty virtuální diskové jednotky připojené k virtuálnímu počítači VM02, které nejsou virtuálními pevnými disky. Příkaz získá pouze objekty, které představují průchozí disky. Příkaz ukládá průchozí diskové objekty do pole objektů $VDDs.

Poslední příkaz používá příkaz If k určení, jestli existuje alespoň jedna předávací virtuální disková jednotka. Pokud je výsledkem jeden nebo více, příkaz použije příkaz ForEach k odebrání každé virtuální diskové jednotky z pole objektů. Další informace potřebujete zadáním Get-Help about_If a Get-Help about_Foreach.

Poslední příkaz určuje parametr Force. Proto příkaz odebere každou virtuální diskovou jednotku z virtuálního počítače, i když ostatní objekty VMM závisí na této virtuální diskové jednotce.

Příklad 3: Odebrání virtuálních diskových jednotek podle názvu

PS C:\> $VM = @(Get-SCVirtualMachine | Where-Object {$_.Name -Match "WebSrvLOB"})
PS C:\> ForEach-Object ($VM in $VMs){$VirtDiskDrives = Get-SCVirtualDiskDrive -VM $VM 
PS C:\> ForEach-Object ($VirtDiskDrive in $VirtDiskDrives){If($VirtDiskDrive.Name -Match "LOBData"){Remove-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive}}}

První příkaz získá všechny objekty virtuálního počítače, jejichž název odpovídá řetězci WebSrvLOB, a pak tyto objekty uloží do pole $VM.

Následující dva příkazy používají rutinu ForEach-Object k iteraci virtuálních počítačů uložených v $VM k získání všech objektů virtuálních disků z každého virtuálního počítače. Druhý příkaz uloží objekty virtuální diskové jednotky do pole objektů $VirtDiskDrives.

Třetí příkaz používá druhou smyčku ForEach k výběru všech objektů virtuálních diskových jednotek, jejichž název obsahuje řetězec LOBData z pole $VirtDiskDrives a předá tyto objekty aktuální rutině. Tato rutina odebere objekty z nástroje VMM.

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í dokončení operace.

Typ:SwitchParameter
Position:Named
Default value:None
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 spouští jako sada těsně před posledním příkazem, který obsahuje stejný identifikátor skupiny úloh.

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

-JobVariable

Určuje proměnnou, ve které je průběh úlohy sledován a uložen.

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

-SkipDeleteVHD

Označuje, že tato rutina při odebírání virtuální diskové jednotky neskládá soubor VHD.

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

-VirtualDiskDrive

Určuje objekt virtuální diskové jednotky. K objektu virtuální diskové jednotky můžete připojit virtuální pevný disk nebo průchozí disk.

Typ:VirtualDiskDrive
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í diskové jednotky VMM, který lze načíst pomocí rutiny Get-SCVirtualDiskDrive.