Get-SCVirtualScsiAdapter

Ruft ein virtuelles 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 virtuellen Computerobjekt, 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 virtuelle Computerobjekt 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 Informationen zu den Adaptern an den Benutzer 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 variablen $VMTemplate.

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 namens 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 Informationen zu den Adaptern an den Benutzer an.

Parameter

-All

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

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

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

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

-ID

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

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Dieses Cmdlet legt die Benutzerrolle im Namen der Benutzerrolle als die Benutzerrolle fest, die dieser Parameter angibt. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das Cmdlet Get-SCUserRole .

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

-VM

Gibt ein Objekt virtueller Maschinen an.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMTemplate

Gibt ein zum Erstellen virtueller Maschinen verwendetes VMM-Vorlagenobjekt an.

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

Ausgaben

VirtualSCSIAdapter

Dieses Cmdlet gibt ein VirtualSCSIAdapter -Objekt zurück.

Hinweise

  • Erfordert ein virtuelles VMM-Computerobjekt, ein virtuelles Computervorlagenobjekt oder ein Hardwareprofilobjekt, das mithilfe der Cmdlets Get-SCVirtualMachine, Get-SCVMTemplate oder Get-SCHardwareProfile abgerufen werden kann.