Dela via

Get-SCVMCheckpoint

  • Referens
Modul:
VirtualMachineManager

Hämtar kontrollpunktsobjekt för virtuella datorer från VMM-databasen.

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

Cmdleten Get-SCVMCheckpoint hämtar ett eller flera kontrollpunktsobjekt för virtuella datorer från VMM-databasen (Virtual Machine Manager).

En kontrollpunkt för virtuella datorer är en "ögonblicksbild" av en virtuell dator. Du kan använda kontrollpunkten för att återställa en virtuell dator till ett tidigare tillstånd. Om du vill ha mer information om VMM-kontrollpunkter skriver du Get-Help New-VMCheckpoint -Detailed.

Exempel

Exempel 1: Hämta alla befintliga kontrollpunkter för varje virtuell dator

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

Det här kommandot hämtar alla befintliga kontrollpunktsobjekt för varje virtuell dator som hanteras av VMMServer01 och visar information om dessa kontrollpunktsobjekt för användaren.

Exempel 2: Hämta alla kontrollpunkter för en eller flera virtuella datorer med ett specifikt namn

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

Det första kommandot hämtar alla kontrollpunktsobjekt för den virtuella datorn VM01 och lagrar objekten i $Checkpoints-objektmatrisen.

Det andra kommandot visar information om kontrollpunktsobjekten i $Checkpoints.

Exempel 3: Hämta maskinvaruprofilen för den senast skapade kontrollpunkten på en virtuell dator som distribuerats på en Hyper-V-värd

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

Det första kommandot hämtar det virtuella datorobjektet VM01 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar det senaste kontrollpunktsobjektet som skapats för VM01 och lagrar objektet i variabeln $Checkpoint.

Det sista kommandot visar information om maskinvaruprofilen för kontrollpunkten som lagras i $Checkpoint (det senaste kontrollpunktsobjektet som skapats för VM01).

Exempel 4: Visa .NET-typ, händelser, metoder och egenskaper för kontrollpunktsobjekt

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

Det första kommandot hämtar alla kontrollpunktsobjekt på VMMServer01 och lagrar objekten i $Checkpoints objektmatris.

Det andra kommandot skickar varje kontrollpunktsobjekt i $Checkpoints till cmdleten Get-Member , som visar .NET TypeName och Namn, MemberType och Definition för varje händelse, metod och egenskap som är associerad med den här objekttypen.

Det sista kommandot är samma som det andra kommandot förutom att det skickar utdata till Format-List cmdlet så att du kan se den fullständiga definitionen för varje händelse, metod och egenskap för kontrollpunktsobjekttypen.

Parametrar

-ID

Anger den numeriska identifieraren som en globalt unik identifierare, eller GUID, för ett specifikt objekt.

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

-MostRecent

Anger det senaste kontrollpunktsobjektet för virtuella VMM-datorer.

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

-OnBehalfOfUser

Anger namnet på en användare. Den här cmdleten anger för användarens räkning som den användare som den här parametern anger.

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

-OnBehalfOfUserRole

Anger en användarroll. Om du vill hämta en användarroll använder du cmdleten Get-SCUserRole . Den här cmdleten fungerar för den användarroll som den här parametern anger.

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

-VM

Anger ett virtuellt datorobjekt.

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

-VMMServer

Anger ett VMM-serverobjekt.

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

Utdata

VMCheckpoint

Den här cmdleten returnerar ett VMCheckpoint-objekt .