Get-SCVirtualHardDisk

Модуль:
VirtualMachineManager Module

Получает объекты виртуального жесткого диска с виртуальной машины, из шаблона или в виде отдельного файла, хранящегося в библиотеке VMM.

Синтаксис

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

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

Template 

Get-SCVirtualHardDisk
    -VMTemplate <Template>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VM 

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

NameParamSet 

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

EquivalentResourceParamSet 

Get-SCVirtualHardDisk
    -FamilyName <String>
    [-VMMServer <ServerConnection>]
    [-Release <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ID 

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

Описание

Командлет Get-SCVirtualHardDisk получает объекты виртуального жесткого диска с виртуальной машины, из шаблона или в виде отдельного файла, хранящегося в библиотеке диспетчера виртуальных машин (VMM).

Виртуальный жесткий диск может быть VHD-файлом на основе Windows, VHD-файлом на основе Citrix XenServer или VMware-файлом .vmdk. Виртуальный жесткий диск может храниться как автономный объект в библиотеке VMM, быть подключен к виртуальному диску на шаблоне или подключен к виртуальному диску на развернутой или сохраненной виртуальной машине.

Примеры

Пример 1: Получение объекта виртуального жесткого диска из библиотеки

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

Эта команда получает объект виртуального жесткого диска с именем VHD01.vhd, хранящийся на сервере LibraryServer01, а затем сохраняет объект в переменной $VHD.

Пример 2: Получение объекта виртуального жесткого диска из виртуальной машины

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }

Первая команда подключается к VMMServer01.

Вторая команда получает объект виртуальной машины с именем VM01, выбирает все виртуальные жесткие диски на VM01, имя которых содержит строку "DataDisk", а затем сохраняет возвращенные объекты виртуального жесткого диска в переменной $VHD.

Пример 3: Получение объекта виртуального жесткого диска из определенного шаблона

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk

Эта команда получает объект шаблона с именем Template01 из библиотеки и отображает все объекты виртуального жесткого диска в этом шаблоне.

Параметры

-All

Указывает, что этот командлет получает все подчиненные объекты независимо от родительского объекта. Например, команда Get-SCVirtualDiskDrive -All получает все объекты виртуального диска независимо от объекта виртуальной машины или объекта шаблона, с которым связан каждый объект виртуального диска.

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

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

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

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

-FamilyName

Указывает имя семейства для физического ресурса в библиотеке VMM. Это значение используется в сочетании с параметрами Release, Namespace и Type для установления эквивалентности библиотечных ресурсов.

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

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

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

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

-ID

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

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

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

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

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

-Name

Указывает имя объекта VMM.

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

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

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

NameParamSet
Position:Named
Обязательно:True
Значение из конвейера: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

-Release

Указывает строку, описывающую освобождение ресурса библиотеки. VMM автоматически создает значение выпуска для каждого ресурса, импортированного в библиотеку. После импорта ресурса строку можно настроить.

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

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

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

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

-VM

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

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

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

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

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

-VMMServer

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

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

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

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

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

-VMTemplate

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

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

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

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

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

CommonParameters

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

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

VirtualHardDisk

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

Примечания

  • Требуется объект виртуальной машины VMM или объект шаблона VMM, который можно получить с помощью командлета Get-SCVirtualMachine или командлета Get-SCVMTemplate соответственно.