Udostępnij przez

Remove-SCVirtualDVDDrive

Moduł:
VirtualMachineManager Module

Usuwa obiekt wirtualnej stacji dysków DVD z programu VMM.

Składnia

VirtualDVDDriveSpecified 

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

SourceBusAndLunSpecified 

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 obiekt wirtualnej stacji dysków 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ż wszystkie pliki .iso używane przez wirtualną stację dysków DVD z systemu plików na serwerze biblioteki.

To polecenie cmdlet zwraca obiekt po pomyślnym zakończeniu (z właściwością MarkedForDeletion ustawioną na wartość True) lub zwraca komunikat o błędzie w przypadku niepowodzenia.

Przykłady

Przykład 1: Usuwanie określonego wirtualnego napędu 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 obiekt wirtualnego napędu DVD znajdujący się w pierwszym gnieździe kanału pomocniczego (określonym przez -Bus 1 i -LUN 0) na magistrali IDE na VM01, a następnie zapisuje obiekt wirtualnego napędu DVD w zmiennej $DVDDrive.

Ostatnie polecenie usuwa obiekt wirtualnego napędu DVD przechowywany w $DVDDrive z VM01 i usuwa wszystkie pliki .iso używane przez ten wirtualny napęd DVD z systemu plików na serwerze biblioteki.

Przykład 2: Usuwanie trzeciego wirtualnego napędu 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 zapisuje go w zmiennej $VM.

Drugie polecenie pobiera wszystkie obiekty wirtualnego napędu DVD podłączone do VM02 i zapisuje każdy obiekt wirtualnego napędu DVD w tablicy obiektów $DVDDrive. W tym przykładzie założono, że VM02 ma trzy wirtualne stacje dysków DVD i dlatego tablica zawiera trzy elementy (licząc od 0 do 2).

Ostatnie polecenie przekazuje trzeci wirtualny napęd DVD (obiekt [2]) przechowywany w $DVDDrive do polecenia cmdlet Remove-SCVirtualDVDDrive , które usuwa ten obiekt wirtualnego napędu DVD z maszyny VM02 i usuwa wszystkie pliki .iso używane przez ten wirtualny napęd DVD z systemu plików na serwerze biblioteki.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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ń.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

VirtualDVDDriveSpecified
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OnBehalfOfUser

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

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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 określonej przez ten parametr.

Właściwości parametru

Typ:UserRole
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów: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.

Właściwości parametru

Typ:Guid
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsynchronously

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

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SourceBus

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

Właściwości parametru

Typ:Byte
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SourceBusAndLunSpecified
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SourceLUN

Określa źródłowy numer jednostki logicznej (LUN) dla obiektu wirtualnego napędu DVD na magistrali IDE.

Właściwości parametru

Typ:Byte
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SourceBusAndLunSpecified
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VirtualDVDDrive

Określa obiekt wirtualnej stacji dysków DVD.

Właściwości parametru

Typ:VirtualDVDDrive
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

VirtualDVDDriveSpecified
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Uwagi

  • Wymaga obiektu wirtualnego napędu DVD programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualDVDDrive .