Compartilhar via

Get-SCVMCheckpoint

Módulo:
VirtualMachineManager Module

Obtém objetos de ponto de verificação de máquina virtual do banco de dados do VMM.

Sintaxe

Connection (Padrão) 

Get-SCVMCheckpoint
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VM 

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

ID 

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

Description

O cmdlet Get-SCVMCheckpoint obtém um ou mais objetos de ponto de verificação de máquina virtual do banco de dados do VMM (Virtual Machine Manager).

Um ponto de verificação de máquina virtual é um "instantâneo" pontual de uma máquina virtual. Você pode usar o ponto de verificação para reverter uma máquina virtual para um estado anterior. Para obter mais informações sobre pontos de verificação do VMM, digite Get-Help New-VMCheckpoint -Detailed.

Exemplos

Exemplo 1: Obter todos os pontos de verificação existentes para cada máquina virtual

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

Esse comando obtém todos os objetos de ponto de verificação existentes para cada máquina virtual gerenciada pelo VMMServer01 e exibe informações sobre esses objetos de ponto de verificação para o usuário.

Exemplo 2: Obter todos os pontos de verificação para uma ou mais máquinas virtuais com um nome específico

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

O primeiro comando obtém todos os objetos de ponto de verificação para a máquina virtual VM01 e armazena os objetos na matriz de objetos $Checkpoints.

O segundo comando exibe informações sobre os objetos de ponto de verificação em $Checkpoints.

Exemplo 3: Obter o perfil de hardware do ponto de verificação criado mais recentemente em uma VM implantada em um host Hyper-V

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

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto de ponto de verificação mais recente criado para VM01 e armazena o objeto na variável $Checkpoint.

O último comando exibe informações sobre o perfil de hardware para o ponto de verificação armazenado no $Checkpoint (o objeto de ponto de verificação mais recente criado para VM01).

Exemplo 4: Exibir o tipo, os eventos, os métodos e as propriedades do .NET para objetos de ponto de verificação

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

O primeiro comando obtém todos os objetos de ponto de verificação no VMMServer01 e armazena os objetos na matriz de objetos $Checkpoints.

O segundo comando passa cada objeto de ponto de verificação em $Checkpoints para o cmdlet Get-Member , que exibe o .NET TypeName e o Name, MemberType e Definition para cada evento, método e propriedade associados a esse tipo de objeto.

O último comando é o mesmo que o segundo comando, exceto que ele canaliza a saída para o cmdlet Format-List para que você possa ver a definição completa de cada evento, método e propriedade para o tipo de objeto de ponto de verificação.

Parâmetros

-ID

Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ID
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MostRecent

Especifica o objeto de ponto de verificação da máquina virtual do VMM mais recente.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VM
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUser

Especifica o nome de um usuário. Esse cmdlet define o nome do usuário como o usuário especificado por esse parâmetro.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Propriedades do parâmetro

Tipo:UserRole
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VM

Especifica um objeto de máquina virtual.

Propriedades do parâmetro

Tipo:VM
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VM
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

VMCheckpoint

Esse cmdlet retorna um objeto VMCheckpoint .