Share via

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 virtuellen Computervorlage in einer Virtual Machine Manager-Umgebung (VMM). Mit diesem Cmdlet können Sie den Bustyp (IDE oder SCSI) ändern oder die Bus- und LUN-Einstellungen ändern, um ein virtuelles Datenträgerlaufwerk an einen 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 virtuelle Computerobjekt VM01 mithilfe des Cmdlets Get-SCVirtualMachine ab. Der Befehl speichert dieses Objekt in der $VM Variablen.

Der zweite Befehl ruft das virtuelle Datenträgerlaufwerkobjekt auf VM01 ab, und speichert das Objekt dann in $VirtDiskDrive. Wenn Sie das @-Symbol und die Klammern verwenden, stellen Sie 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 ein virtuelles Datenträgerlaufwerk aufweist und sich im zweiten Steckplatz des ersten IDE-Kanals befindet.

Beispiel 2: Ändern des Bustyps für ein virtuelles Datenträgerlaufwerk 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 virtuelle Computerobjekt namens 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 virtuellen Datenträgerlaufwerkobjekte im $VirtDiskDrive-Objektarray. In diesem Beispiel wird angenommen, dass sich das virtuelle Laufwerk an einem SCSI-Bus befindet.

Der letzte Befehl legt den Bustyp auf IDE fest. Der Befehl verbindet das zweite virtuelle Datenträgerlaufwerk, das durch $VirtDiskDrive[1], mit primärem Kanal (1) und Slot 2 angegeben wird, angegeben von -Bus 0 und LUN 1.

Parameter

-Bus

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

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

-CreateDiffDisk

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

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

-DisableStorageQoS

Gibt an, dass dieses Cmdlet speicherqualitätsqualität (QoS)-Standards deaktiviert.

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

-IDE

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

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

-IOPSMaximum

Gibt die maximale IOPS an.

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

-JobGroup

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

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

-JobVariable

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

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

-LUN

Gibt die logische Einheitsnummer (LUN) für ein virtuelles Laufwerkobjekt oder ein virtuelles Datenträgerlaufwerkobjekt auf einem SCSI-Bus an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, 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. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-PROTipID

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

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-SCSI

Gibt SCSI als Bustyp an, mit dem ein auf einer virtuellen Maschine oder in einer Vorlage konfiguriertes virtuelles Laufwerksobjekt verbunden werden soll.

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

-SharedStorage

Gibt an, ob das virtuelle Datenträgerlaufwerk freigegebenen Speicher verwendet.

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

-StorageClassification

Gibt ein Speicherklassifizierungsobjekt an.

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

-StorageQoSPolicy

Gibt eine Speicher-QoS-Richtlinie an.

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

-VirtualDiskDrive

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

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

-VolumeType

Gibt den Volumetyp für eine virtuelle Festplatte an. Zulässige Werte für diesen Parameter:

  • Start
  • System
  • BootAndSystem
  • Keine
Type:VolumeType
Accepted values:None, Boot, System, BootAndSystem
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

VirtualDiskDrive

Dieses Cmdlet gibt ein VirtualDiskDrive-Objekt zurück.

Hinweise

  • Dieses Cmdlet erfordert ein virtuelles VMM-Laufwerkobjekt, das mithilfe des Cmdlets Get-SCVirtualDiskDrive abgerufen werden kann.