Freigeben über


Get-SCVirtualDVDDrive

Ruft ein virtuelles VMM-DVD-Laufwerkobjekt aus einer virtuellen Maschine, einer VM-Vorlage oder einem Hardwareprofil ab.

Syntax

All

Get-SCVirtualDVDDrive
    [-VMMServer <ServerConnection>]
    [-All]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

HardwareProfile

Get-SCVirtualDVDDrive
    -HardwareProfile <HardwareProfile>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VM

Get-SCVirtualDVDDrive
    -VM <VM>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Template

Get-SCVirtualDVDDrive
    -VMTemplate <Template>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ID

Get-SCVirtualDVDDrive
    [-ID] <Guid>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCVirtualDVDDrive ruft ein oder mehrere virtuelle DVD-Laufwerksobjekte (Virtual Machine Manager, VMM) aus einem VM-Objekt, einem VM-Vorlagenobjekt oder einem Hardwareprofilobjekt ab.

Beispiele

Beispiel 1: Abrufen virtueller DVD-Laufwerke von einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualDVDDrive -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 DVD-Laufwerksobjekte auf VM01 ab und zeigt dem Benutzer Informationen zu diesen virtuellen DVD-Laufwerken an.

Beispiel 2: Abrufen virtueller DVD-Laufwerke aus einer Vorlage

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

Mit dem ersten Befehl werden alle Vorlagenobjekte für virtuelle Maschinen abgerufen, die in der VMM-Bibliothek gespeichert sind, das Vorlagenobjekt mit dem Namen VMTemplate01 ausgewählt und dann in der Variablen $Template gespeichert.

Der zweite Befehl ruft alle virtuellen DVD-Laufwerksobjekte auf VMTemplate01 ab und zeigt dem Benutzer Informationen zu diesen virtuellen DVD-Laufwerken an.

Beispiel 3: Abrufen virtueller DVD-Laufwerke aus einem Hardwareprofil

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

Mit dem ersten Befehl werden alle Hardwareprofilobjekte in der VMM-Bibliothek abgerufen, das Profilobjekt mit dem Namen NewHWProfile01 ausgewählt und dann in der Variablen $HWProfile gespeichert.

Der zweite Befehl ruft alle virtuellen DVD-Laufwerksobjekte auf NewHHWProfile01 ab und zeigt dem Benutzer Informationen zu diesen virtuellen DVD-Laufwerken an.

Parameter

-All

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

All
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Parametereigenschaften

Typ:HardwareProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

HardwareProfile
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ID

Gibt den numerischen Bezeichner als GUID (Globally Unique Identifier) für ein bestimmtes Objekt an.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ID
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VM

Gibt ein Objekt eines virtuellen Computers an.

Parametereigenschaften

Typ:VM
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

VM
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMTemplate

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

Parametereigenschaften

Typ:Template
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Schablone

Parametersätze

Template
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

VirtualDVDDrive

Dieses Cmdlet gibt ein VirtualDVDDrive-Objekt zurück.

Hinweise

  • Erfordert ein VMM-VM-Objekt, ein VM-Vorlagenobjekt oder ein Hardwareprofilobjekt. Sie können diese Objekte mit den Cmdlets Get-SCVirtualMachine, Get-SCVMTemplate bzw. Get-SCHardwareProfile abrufen.