Udostępnij za pośrednictwem

Remove-SCVirtualScsiAdapter

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa obiekt wirtualnej karty SCSI z programu VMM.

Składnia

Remove-SCVirtualScsiAdapter
      [-VirtualScsiAdapter] <VirtualSCSIAdapter>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-SCVirtualScsiAdapter usuwa co najmniej jeden obiekt wirtualnej karty SCSI z maszyny wirtualnej, szablonu maszyny wirtualnej lub profilu sprzętu używanego w środowisku programu Virtual Machine Manager (VMM).

Polecenie cmdlet Remove-SCVirtualSCSIAdapter usuwa wirtualną kartę SCSI tylko wtedy, gdy karta nie ma żadnych dołączonych do niego urządzeń.

Maszyna wirtualna na hoście Citrix XenServer zawsze ma jedną wirtualną kartę SCSI. Nie można usunąć tej karty.

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

Przykłady

Przykład 1: Usuwanie trzeciej wirtualnej karty SCSI z maszyny wirtualnej

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualSCSIAdapter -VM $VM 
PS C:\> $Adapter[2] | Remove-SCVirtualScsiAdapter

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

Drugie polecenie pobiera wszystkie obiekty wirtualnej karty SCSI na maszynie VM01 i przechowuje obiekty w tablicy obiektów $Adapter. Maszyna wirtualna może mieć dołączone maksymalnie cztery wirtualne karty SCSI. W tym przykładzie przyjęto założenie, że maszyna VM01 ma co najmniej trzy wirtualne karty SCSI.

Ostatnie polecenie przekazuje trzecią wirtualną kartę SCSI ($Adapter[2]) do Remove-SCVirtualScsiAdapter, która usuwa tę wirtualną kartę SCSI z maszyny wirtualnej VM01.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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ń.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobVariable

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUserRole

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

Typ:UserRole
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VirtualScsiAdapter

Określa obiekt wirtualnej karty SCSI dla maszyny wirtualnej.

Typ liczby hostów wirtualnych kart SCSI

Hyper-V: maksymalnie cztery syntetyczne wirtualne karty SCSI na maszynę wirtualną i maksymalnie 64 urządzenia na kartę. Obsługuje rozmiar dysku wirtualnego do 2040 GB. Nie obsługuje emulowanych wirtualnych kart SCSI. VMware ESX: maksymalnie cztery wirtualne karty SCSI na maszynę wirtualną i maksymalnie 15 urządzeń na kartę. Obsługuje rozmiar dysku wirtualnego do 2048 GB. Citrix XenServer: zawsze jedna wirtualna karta SCSI na maszynę wirtualną i maksymalnie osiem urządzeń na kartę. Obsługuje rozmiar dysku wirtualnego do 2048 GB.

Typ:VirtualSCSIAdapter
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

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

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Uwagi

  • Wymaga obiektu wirtualnej karty SCSI programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualScsiAdapter.