Freigeben über

Set-SCVirtualDiskDrive

Modul:
VirtualMachineManager Module

Ändert die Einstellungen eines virtuellen Laufwerks.

Syntax

BusChanges (Standardwert) 

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

StorageQoSPolicy 

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

IOPSMaximum 

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

DisableStorageQoS 

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

Beschreibung

Mit dem Cmdlet Set-SCVirtualDiskDrive werden die Einstellungen eines virtuellen Laufwerks auf einem virtuellen Computer oder in einer VMM-Vorlage in einer Virtual Machine Manager (VMM)-Umgebung geändert. Mit diesem Cmdlet können Sie den Bustyp (IDE oder SCSI) oder die Bus- und LUN-Einstellungen ändern, um ein virtuelles Laufwerk mit einer anderen Position auf dem Bus zu verbinden.

Beispiele

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

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}

Mit dem ersten Befehl wird das VM-Objekt VM01 mithilfe des Cmdlets Get-SCVirtualMachine abgerufen. Der Befehl speichert dieses Objekt in der Variablen $VM.

Mit dem zweiten Befehl wird das Objekt des virtuellen Laufwerks auf VM01 abgerufen und dann in $VirtDiskDrive gespeichert. Stellen Sie mithilfe des @-Symbols und in Klammern sicher, dass der Befehl die Ergebnisse in einem Array speichert, auch wenn der Befehl ein einzelnes Objekt oder einen $Null Wert zurückgibt.

Mit dem letzten Befehl wird der Buswert auf 0 und der LUN-Wert für das virtuelle Laufwerk auf VM01 auf 0 festgelegt, wenn die virtuelle Maschine 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 VM-Objekt mit dem Namen VM02 ab und speichert dieses Objekt dann in der Variablen $VM.

Mit dem zweiten Befehl werden alle virtuellen Laufwerksobjekte abgerufen, die für den virtuellen Computer konfiguriert sind, der in $VM gespeichert ist, und diese Objekte des virtuellen Laufwerks im $VirtDiskDrive Objektarray gespeichert. In diesem Beispiel wird davon ausgegangen, dass sich das virtuelle Laufwerk an einem SCSI-Bus befindet.

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

Parameter

-Bus

Gibt den IDE-Bus an, an den ein virtuelles Laufwerk angeschlossen werden soll, oder den SCSI-Bus, an den ein virtuelles Laufwerk angeschlossen werden soll.

Parametereigenschaften

Typ:Byte
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

-CreateDiffDisk

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

Parametereigenschaften

Typ:Boolean
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

-DisableStorageQoS

Gibt an, dass dieses Cmdlet QoS-Standards (Quality of Service) für den Speicher deaktiviert.

Parametereigenschaften

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

Parametersätze

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

-IDE

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

Parametereigenschaften

Typ:SwitchParameter
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

-IOPSMaximum

Gibt den maximalen IOPS an.

Parametereigenschaften

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

Parametersätze

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz ausgeführt werden, kurz bevor der letzte Befehl ausgeführt wird, der denselben Auftragsgruppenbezeichner enthält.

Parametereigenschaften

Typ:Guid
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

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt verfolgt und gespeichert 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

-LUN

Gibt die LUN (Logical Unit Number) für ein virtuelles Laufwerksobjekt oder für ein virtuelles Laufwerksobjekt auf einem SCSI-Bus an.

Parametereigenschaften

Typ:Byte
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

-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

-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.

Parametereigenschaften

Typ:Guid
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

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
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

-SCSI

Gibt SCSI als Bustyp an, an den ein virtuelles Laufwerksobjekt angehängt werden soll, das auf einem virtuellen Computer oder in einer Vorlage konfiguriert ist.

Parametereigenschaften

Typ:SwitchParameter
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

-SharedStorage

Gibt an, ob das virtuelle Laufwerk freigegebenen Speicher verwendet.

Parametereigenschaften

Typ:Boolean
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

-StorageClassification

Gibt ein Speicherklassifizierungsobjekt an.

Parametereigenschaften

Typ:StorageClassification
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

-StorageQoSPolicy

Gibt eine Speicher-QoS-Richtlinie an.

Parametereigenschaften

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

Parametersätze

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

-VirtualDiskDrive

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

Parametereigenschaften

Typ:VirtualDiskDrive
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

-VolumeType

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

  • Start
  • System
  • BootAndSystem
  • Nichts

Parametereigenschaften

Typ:VolumeType
Standardwert:None
Zulässige Werte:None, Boot, System, BootAndSystem
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

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

VirtualDiskDrive

Dieses Cmdlet gibt ein VirtualDiskDrive-Objekt zurück.

Hinweise

  • Für dieses Cmdlet ist ein virtuelles VMM-Laufwerksobjekt erforderlich, das mit dem Cmdlet Get-SCVirtualDiskDrive abgerufen werden kann.