Udostępnij za pośrednictwem

Remove-SCVirtualDVDDrive

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa obiekt wirtualnego dysku DVD z programu VMM.

Składnia

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>]

Opis

Polecenie cmdlet Remove-SCVirtualDVDDrive usuwa co najmniej jeden wirtualny dysk DVD z profilu sprzętu, maszyny wirtualnej lub szablonu maszyny wirtualnej używanego w środowisku programu Virtual Machine Manager (VMM). Polecenie cmdlet usuwa również dowolny plik ISO używany przez wirtualną stację DYSKÓW DVD z systemu plików na serwerze biblioteki.

To polecenie cmdlet zwraca obiekt po powodzeniu (z właściwością MarkedForDeletion ustawioną na True) lub zwraca komunikat o błędzie po niepowodzeniu.

Przykłady

Przykład 1: Usuwanie określonej wirtualnej stacji dysków DVD z maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera wirtualny obiekt stacji dysków DVD znajdujący się w pierwszym miejscu kanału pomocniczego (określone przez -Bus 1 i -LUN 0) w magistrali IDE na maszynie VM01, a następnie zapisuje wirtualny obiekt stacji DYSKÓW DVD w zmiennej $DVDDrive.

Ostatnie polecenie usuwa wirtualny obiekt stacji dysków DVD przechowywany w $DVDDrive z vm01 i usuwa dowolny plik ISO używany przez ten wirtualny dysk DVD z systemu plików na serwerze biblioteki.

Przykład 2: Usuwanie trzeciej wirtualnej stacji dysków DVD z maszyny wirtualnej

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

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM02 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera wszystkie obiekty wirtualnego dysku DVD podłączone do maszyny wirtualnej VM02 i przechowuje każdy wirtualny obiekt stacji dysków DVD w tablicy obiektów $DVDDrive. W tym przykładzie przyjęto założenie, że maszyna VM02 ma trzy wirtualne dyski DVD, dlatego tablica zawiera trzy elementy (zliczanie od 0 do 2).

Ostatnie polecenie przekazuje trzeci wirtualny dysk DVD (obiekt [2]) przechowywany w $DVDDrive do polecenia cmdlet Remove-SCVirtualDVDDrive , który usuwa ten wirtualny obiekt dysku DVD z VM02 i usuwa wszystkie pliki ISO używane przez ten wirtualny dysk DVD z systemu plików na serwerze biblioteki.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-JobGroup

Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

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

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-SourceBus

Określa źródłową magistralę IDE dla dysku.

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

-SourceLUN

Określa źródłowy numer jednostki logicznej (LUN) dla wirtualnego obiektu stacji dysków DVD w magistrali IDE.

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

-VirtualDVDDrive

Określa wirtualny obiekt stacji dysków DVD.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Uwagi

  • Wymaga obiektu wirtualnego dysku DVD programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCVirtualDVDDrive .