Get-SCVMCheckpoint

Получает объекты контрольных точек виртуальной машины из базы данных VMM.

Синтаксис

Connection (по умолчанию)

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>]

Описание

Командлет Get-SCVMCheckpoint получает один или несколько объектов контрольных точек виртуальной машины из базы данных диспетчера виртуальных машин (VMM).

Контрольная точка виртуальной машины — это моментальный снимок виртуальной машины на определенный момент времени. Контрольную точку можно использовать для возврата виртуальной машины в предыдущее состояние. Для получения дополнительной информации о контрольных точках VMM введите Get-Help New-VMCheckpoint -Detailed.

Примеры

Пример 1: Получение всех существующих контрольных точек для каждой виртуальной машины

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

Эта команда получает все существующие объекты контрольных точек для каждой виртуальной машины, управляемой VMMServer01, и отображает информацию об этих объектах контрольных точек для пользователя.

Пример 2: Получение всех контрольных точек для одной или нескольких виртуальных машин с определенным именем

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

Первая команда получает все объекты контрольных точек для виртуальной машины VM01 и сохраняет объекты в массиве объектов $Checkpoints.

Вторая команда выводит информацию об объектах контрольных точек в $Checkpoints.

Пример 3: Получение профиля оборудования последней созданной контрольной точки на виртуальной машине, развернутой на Hyper-V хосте

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

Первая команда получает объект виртуальной машины с именем VM01 и сохраняет объект в переменной $VM.

Вторая команда получает самый последний объект контрольной точки, созданный для VM01, и сохраняет объект в переменной $Checkpoint.

Последняя команда отображает информацию об аппаратном профиле для контрольной точки, хранящейся в $Checkpoint (самый последний объект контрольной точки, созданный для VM01).

Пример 4: Отображение типа, событий, методов и свойств .NET для объектов контрольных точек

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

Первая команда получает все объекты контрольных точек на VMMServer01 и сохраняет объекты в массиве объектов $Checkpoints.

Вторая команда передает каждый объект контрольной точки в $Checkpoints командлету Get-Member , который отображает .NET TypeName и Name, MemberType и Definition для каждого события, метода и свойства, связанных с этим типом объекта.

Последняя команда аналогична второй, за исключением того, что она передает выходные данные в командлет Format-List, чтобы вы могли увидеть полное определение для каждого события, метода и свойства для типа объекта контрольной точки.

Параметры

-ID

Указывает числовой идентификатор в качестве глобального уникального идентификатора или GUID для конкретного объекта.

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ID
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MostRecent

Указывает самый последний объект контрольной точки виртуальной машины VMM.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VM
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет задает от имени пользователя, указанного этим параметром.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OnBehalfOfUserRole

Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной в этом параметре.

Свойства параметра

Тип:UserRole
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VM

Указывает объект виртуальной машины.

Свойства параметра

Тип:VM
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VM
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMMServer

Указывает объект сервера VMM.

Свойства параметра

Тип:ServerConnection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

VMCheckpoint

Этот командлет возвращает объект VMCheckpoint .