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 virtuelle Datenträgerdatei 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 Datenträgerlaufwerkobjekt 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 virtuelle Computerobjekt namens 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 dem ersten Controller ($) ab. Bus -Eq 0) und erster Steckplatz dieses Controllers ($). Lun -Eq 0) von VM01 und speichert dieses Objekt in der $VirtDiskDrive Variablen.

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

Parameter

-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

-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. Geben Sie diesen Parameter und den Parameter OnBehalfOfUser an, um Berechtigungen aus einer Benutzerrolle zu entfernen, die zu einem Benutzerauftrag gehört. Verwenden Sie zum Abrufen eines Benutzerrolleobjekts das Cmdlet Get-SCUserRole .

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

-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:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualHardDiskSizeGB

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

Type:Int32
Aliases:Size
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

VirtualHardDisk

Dieses Cmdlet gibt ein VirtualHardDisk-Objekt zurück.

Hinweise

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