Delen via

Get-SCVMCheckpoint

  • Referentie
Module:
VirtualMachineManager

Hiermee haalt u controlepuntobjecten voor virtuele machines op uit de VMM-database.

Syntax

Get-SCVMCheckpoint
   [-VMMServer <ServerConnection>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVMCheckpoint
   [-VM <VM>]
   [-VMMServer <ServerConnection>]
   [-MostRecent]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVMCheckpoint
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

De cmdlet Get-SCVMCheckpoint haalt een of meer controlepuntobjecten voor virtuele machines op uit de VMM-database (Virtual Machine Manager).

Een controlepunt voor virtuele machines is een momentopname van een virtuele machine. U kunt het controlepunt gebruiken om een virtuele machine terug te keren naar een eerdere status. Typ voor meer informatie over VMM-controlepunten Get-Help New-VMCheckpoint -Detailed.

Voorbeelden

Voorbeeld 1: Alle bestaande controlepunten voor elke virtuele machine ophalen

PS C:\> Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"

Met deze opdracht worden alle bestaande controlepuntobjecten opgehaald voor elke virtuele machine die wordt beheerd door VMMServer01 en wordt informatie over deze controlepuntobjecten weergegeven aan de gebruiker.

Voorbeeld 2: Alle controlepunten ophalen voor een of meer virtuele machines met een specifieke naam

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM01" 
PS C:\> $Checkpoints

Met de eerste opdracht worden alle controlepuntobjecten opgehaald voor virtuele machine VM01 en worden de objecten opgeslagen in de $Checkpoints objectmatrix.

Met de tweede opdracht wordt informatie weergegeven over de controlepuntobjecten in $Checkpoints.

Voorbeeld 3: Het hardwareprofiel ophalen van het laatst gemaakte controlepunt op een VM die is geïmplementeerd op een Hyper-V-host

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Checkpoint = $VM | Get-SCVMCheckpoint -MostRecent
PS C:\> $Checkpoint.CheckpointHWProfile

Met de eerste opdracht wordt het virtuele-machineobject MET de naam VM01 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht wordt het meest recente controlepuntobject opgehaald dat is gemaakt voor VM01 en wordt het object opgeslagen in de $Checkpoint variabele.

Met de laatste opdracht wordt informatie weergegeven over het hardwareprofiel voor controlepunt dat is opgeslagen in $Checkpoint (het meest recente controlepuntobject dat is gemaakt voor VM01).

Voorbeeld 4: Het .NET-type, gebeurtenissen, methoden en eigenschappen voor controlepuntobjecten weergeven

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Checkpoints | Get-Member
PS C:\> $Checkpoints | Get-Member | Format-List

Met de eerste opdracht worden alle controlepuntobjecten op VMMServer01 opgehaald en worden de objecten opgeslagen in de $Checkpoints objectmatrix.

Met de tweede opdracht wordt elk controlepuntobject in $Checkpoints doorgegeven aan de cmdlet Get-Member , waarin de .NET TypeName en de Naam, MemberType en Definition worden weergegeven voor elke gebeurtenis, methode en eigenschap die aan dit objecttype is gekoppeld.

De laatste opdracht is hetzelfde als de tweede opdracht, behalve dat deze de uitvoer doorgeeft aan de Format-List cmdlet, zodat u de volledige definitie voor elke gebeurtenis, methode en eigenschap voor het objecttype controlepunt kunt zien.

Parameters

-ID

Hiermee geeft u de numerieke id op als een globaal unieke id of GUID voor een specifiek object.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MostRecent

Hiermee geeft u het meest recente controlepuntobject voor de virtuele VMM-machine op.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u de naam van een gebruiker. Met deze cmdlet stelt u de namens de gebruiker in als de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Hiermee geeft u een virtuele-machineobject.

Type:VM
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Hiermee geeft u een VMM-serverobject op.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Uitvoerwaarden

VMCheckpoint

Deze cmdlet retourneert een VMCheckpoint-object .