Freigeben über

Get-SCVirtualScsiAdapter

  • Referenz
Modul:
VirtualMachineManager

Ruft ein VMM virtual SCSI-Adapterobjekt von einem virtuellen Computer, einer Virtuellen Computervorlage oder einem Hardwareprofil ab.

Syntax

Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-SCVirtualScsiAdapter ruft ein oder mehrere virtuelle SCSI-Adapterobjekte ab, die in einer VMM-Umgebung (Virtual Machine Manager) aus einem Objekt eines virtuellen Computers, einem Vorlagenobjekt eines virtuellen Computers oder aus einem Hardwareprofilobjekt verwendet werden.

Ein virtueller Computer auf einem Citrix XenServer-Host verfügt immer über einen virtuellen SCSI-Adapter. Sie können diesen Adapter nicht entfernen oder zusätzliche Adapter hinzufügen.

Beispiele

Beispiel 1: Abrufen aller virtuellen SCSI-Adapter auf einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualScsiAdapter -VM $VM

Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft alle virtuellen SCSI-Adapterobjekte auf VM01 ab und zeigt Dem Benutzer Informationen zu den Adaptern an.

Beispiel 2: Abrufen aller virtuellen SCSI-Adapter in einer Vorlage für virtuelle Computer

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualScsiAdapter -VMTemplate $VMTemplate

Der erste Befehl ruft das VmTemplate01-Vorlagenobjekt des virtuellen Computers aus der VMM-Bibliothek ab und speichert das Objekt in der $VMTemplate Variablen.

Der zweite Befehl ruft alle virtuellen SCSI-Adapterobjekte auf VMTemplate01 ab und zeigt Informationen zu den Adaptern für den Benutzer an.

Beispiel 3: Abrufen aller virtuellen SCSI-Adapter aus einem Hardwareprofil

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualScsiAdapter -HardwareProfile $HWProfile

Der erste Befehl ruft das Hardwareprofilobjekt "NewHWProfile01" aus der VMM-Bibliothek ab und speichert das Objekt in der $HWProfile Variablen.

Der zweite Befehl ruft alle SCSI-Adapterobjekte auf NewHWProfile01 ab und zeigt Dem Benutzer Informationen zu den Adaptern an.

Parameter

-All

Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft. Beispielsweise ruft der Befehl Get-SCVirtualDiskDrive -All alle Objekte des virtuellen Datenträgerlaufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes objekt des virtuellen Datenträgerlaufwerks zugeordnet ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Typ:HardwareProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ID

Gibt den numerischen Bezeichner als global eindeutigen Bezeichner oder GUID für ein bestimmtes Objekt an.

Typ:Guid
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Benutzer im Auftrag des Benutzers als Benutzer fest, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Mit diesem Cmdlet wird die Im Auftrag der Benutzerrolle als Benutzerrolle festgelegt, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das cmdlet Get-SCUserRole.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Typ:VM
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMTemplate

Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird.

Typ:Template
Aliase:Template
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualSCSIAdapter

Dieses Cmdlet gibt ein VirtualSCSIAdapter--Objekt zurück.

Hinweise

  • Erfordert ein VMM-Objekt, ein Vm-Vorlagenobjekt oder ein Hardwareprofilobjekt, das mithilfe der Get-SCVirtualMachine, Get-SCVMTemplate-oder Get-SCHardwareProfile Cmdlets abgerufen werden kann.