Freigeben über


Expand-SCVirtualDiskDrive

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

Syntax

Default (Standardwert)

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

Beschreibung

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

Mit diesem Cmdlet wird eine Windows-basierte VHD- oder VHDX-Datei erweitert, die an ein virtuelles Laufwerksobjekt 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 einer virtuellen Maschine zu erweitern, die auf einem ESX-Host bereitgestellt wurde. Sie können dieses Cmdlet nicht verwenden, um eine virtuelle Festplatte auf einer virtuellen Maschine zu erweitern, die 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

Mit dem ersten Befehl wird das VM-Objekt mit dem Namen 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 abgerufen, das sich auf dem ersten Controller befindet ($. Bus -Eq 0) und den ersten Steckplatz dieses Controllers ($. Lun -Eq 0) von VM01 und speichert dieses Objekt in der Variablen $VirtDiskDrive.

Mit dem letzten Befehl wird die Größe der virtuellen Festplatte, die an das virtuelle Laufwerk angefügt ist, auf 40 GB erweitert.

Parameter

-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

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

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

-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:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualHardDiskSizeGB

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Größe

Parametersätze

(All)
Position:Named
Obligatorisch.:True
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

VirtualHardDisk

Dieses Cmdlet gibt ein VirtualHardDisk-Objekt zurück.

Hinweise

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