Freigeben über

Set-SCVirtualDiskDrive

  • Referenz
Modul:
VirtualMachineManager

Ändert die Einstellungen eines virtuellen Datenträgerlaufwerks.

Syntax

Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -IOPSMaximum <UInt64>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-DisableStorageQoS]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-SCVirtualDiskDrive ändert einstellungen eines virtuellen Datenträgerlaufwerkobjekts auf einem virtuellen Computer oder auf einer Vorlage für virtuelle Computer in einer VMM-Umgebung (Virtual Machine Manager). Mit diesem Cmdlet können Sie den Bus- Typ (IDE oder SCSI) ändern oder die Bus- und LUN-Einstellungen ändern, um ein virtuelles Laufwerk mit einem anderen Speicherort im Bus zu verbinden.

Beispiele

Beispiel 1: Ändern der IDE-Bus- und LUN-Einstellungen für ein virtuelles Datenträgerlaufwerk

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -VM $VM)
PS C:\> If($VirtDiskDrive.Count -Eq 1 -And $VirtDiskDrive[0].Bus -Eq 0 -And $VirtDiskDrive[0].Lun -Eq 1){Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[0] -Bus 0 -LUN 0}

Der erste Befehl ruft das VM01-Objekt des virtuellen Computers mithilfe des Cmdlets Get-SCVirtualMachine ab. Der Befehl speichert dieses Objekt in der $VM Variablen.

Der zweite Befehl ruft das virtuelle Laufwerkobjekt auf VM01 ab und speichert das Objekt dann in $VirtDiskDrive. Stellen Sie mithilfe des @-Symbols und der Klammern sicher, dass der Befehl die Ergebnisse in einem Array speichert, auch wenn der Befehl ein einzelnes Objekt oder einen $Null Wert zurückgibt.

Der letzte Befehl legt den Buswert auf 0 fest und legt den LUN-Wert auf 0 für das virtuelle Datenträgerlaufwerk auf VM01 fest, wenn der virtuelle Computer nur über ein virtuelles Laufwerk verfügt und sich im zweiten Steckplatz des ersten IDE-Kanals befindet.

Beispiel 2: Ändern des Bustyps für ein virtuelles Laufwerk von SCSI in IDE

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[1] -IDE -Bus 0 -LUN 1

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

Der zweite Befehl ruft alle virtuellen Datenträgerlaufwerkobjekte ab, die für den virtuellen Computer konfiguriert sind, der in $VM gespeichert ist, und speichert diese Objekte des virtuellen Datenträgerlaufwerks im $VirtDiskDrive-Objektarray. In diesem Beispiel wird davon ausgegangen, dass sich das virtuelle Laufwerk auf einem SCSI-Bus befindet.

Der letzte Befehl legt den Bustyp auf IDE fest. Der Befehl verbindet das zweite virtuelle Laufwerk, das durch $VirtDiskDrive[1], mit dem primären Kanal (1) und dem Steckplatz 2 angegeben wird, der durch -Bus 0 und LUN 1 angegeben wird.

Parameter

-Bus

Gibt den IDE-Bus an, an den ein virtuelles Laufwerk oder der SCSI-Bus angefügt werden soll, an den ein virtuelles Laufwerk angefügt werden soll.

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

-CreateDiffDisk

Gibt an, ob das Cmdlet einen unterschiedlichen Datenträger erstellt.

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

-DisableStorageQoS

Gibt an, dass dieses Cmdlet die Speicherqualitätsstandards (Quality of Service, QoS) deaktiviert.

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

-IDE

Gibt an, dass IDE der Bustyp ist, an den ein virtuelles Laufwerkobjekt angefügt werden soll, das auf einem virtuellen Computer oder auf einer Vorlage konfiguriert ist.

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

-IOPSMaximum

Gibt den maximalen IOPS-Wert an.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

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

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

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

-LUN

Gibt die logische Einheitennummer (LUN) für ein Virtuelles Laufwerkobjekt oder ein virtuelles Laufwerkobjekt auf einem SCSI-Bus an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-SCSI

Gibt SCSI als Bustyp an, an den ein virtuelles Laufwerkobjekt angefügt werden soll, das auf einem virtuellen Computer oder auf einer Vorlage konfiguriert ist.

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

-SharedStorage

Gibt an, ob das virtuelle Laufwerk gemeinsam genutzten Speicher verwendet.

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

-StorageClassification

Gibt ein Speicherklassifizierungsobjekt an.

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

-StorageQoSPolicy

Gibt eine Speicher-QoS-Richtlinie an.

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

-VirtualDiskDrive

Gibt ein Virtuelles Laufwerkobjekt an. Sie können entweder eine virtuelle Festplatte oder einen Pass-Through-Datenträger an ein virtuelles Laufwerkobjekt anfügen.

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

-VolumeType

Gibt den Volumetyp für eine virtuelle Festplatte an. Die zulässigen Werte für diesen Parameter sind:

  • Booten
  • System
  • BootAndSystem
  • Nichts
Typ:VolumeType
Zulässige Werte:None, Boot, System, BootAndSystem
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualDiskDrive

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

Hinweise

  • Für dieses Cmdlet ist ein virtuelles Laufwerkobjekt vom Typ VMM erforderlich, das mithilfe des Cmdlets Get-SCVirtualDiskDrive abgerufen werden kann.