Freigeben über

Expand-SCVirtualDiskDrive

  • Referenz
Modul:
VirtualMachineManager

Erweitert eine virtuelle Festplatte, die an ein virtuelles Laufwerkobjekt angefügt ist.

Syntax

Expand-SCVirtualDiskDrive
      [-VirtualDiskDrive] <VirtualDiskDrive>
      -VirtualHardDiskSizeGB <Int32>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Expand-SCVirtualDiskDrive erweitert eine virtuelle Festplatte, die an ein virtuelles Laufwerkobjekt angefügt ist, um die Gesamtkapazität der virtuellen Festplatte zu erhöhen. Wenn die Datei des virtuellen Datenträgers eine Verbindung mit der SCSI-Kette eines virtuellen Computers herstellt, können Sie die Größe des virtuellen Datenträgers ändern, während der virtuelle Computer online ist.

Dieses Cmdlet erweitert eine Windows-basierte VHD- oder VHDX-Datei, die an ein Virtuelles Laufwerkobjekt auf einem virtuellen Computer angefügt ist, der auf einem Hyper-V-Host bereitgestellt wird. Sie können dieses Cmdlet auch verwenden, um eine VMware-basierte VMDK-Datei auf einem virtuellen Computer zu erweitern, der auf einem ESX-Host bereitgestellt wird. Sie können dieses Cmdlet nicht verwenden, um eine virtuelle Festplatte auf einem virtuellen Computer zu erweitern, der auf einem Citrix XenServer-Host bereitgestellt wird.

Beispiele

Beispiel 1: Erweitern einer virtuellen Festplatte

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM | Where-Object {$_.Bus -Eq 0 -And $_.Lun -Eq 0}
PS C:\> Expand-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive -VirtualHardDiskSizeGB 40

Der erste Befehl ruft das objekt des virtuellen Computers mit dem Namen VM01 mithilfe des cmdlets Get-SCVirtualMachine ab. Der Befehl speichert dieses Objekt in der $VM Variablen.

Der zweite Befehl ruft das virtuelle Laufwerkobjekt auf dem ersten Controller ($. Bus -Eq 0) und erster Steckplatz dieses Controllers ($. Lun -Eq 0) von VM01 und speichert dieses Objekt in der variablen $VirtDiskDrive.

Der letzte Befehl erweitert die Größe der virtuellen Festplatte, die an das virtuelle Laufwerk angefügt ist, auf 40 GB.

Parameter

-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

-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. Geben Sie diesen Parameter und den parameter OnBehalfOfUser an, um Berechtigungen aus einer Benutzerrolle zu entfernen, die zu einem Im Auftrag des Benutzers gehört. Verwenden Sie zum Abrufen eines Benutzerrollenobjekts das cmdlet Get-SCUserRole.

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

-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:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VirtualHardDiskSizeGB

Gibt die Größe in Gigabyte (GB) an, auf die eine dynamisch erweiterte virtuelle Festplatte erweitert wird.

Typ:Int32
Aliase:Size
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualHardDisk

Dieses Cmdlet gibt ein VirtualHardDisk-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.