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.