Поделиться через

Set-SCVirtualHardDisk

  • Ссылка
Модуль:
VirtualMachineManager

Изменяет свойства объекта виртуального жесткого диска, используемого в VMM.

Синтаксис

Set-SCVirtualHardDisk
   [-OperatingSystem <OperatingSystem>]
   [-VirtualizationPlatform <VirtualizationPlatform>]
   [-Tag <System.Collections.Generic.List`1[System.String]>]
   [-ProductKey <String>]
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisk] <VirtualHardDisk>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Описание

Командлет Set-SCVirtualHardDisk изменяет одно или несколько свойств объекта виртуального жесткого диска, используемого в среде Virtual Machine Manager (VMM). Файл виртуального жесткого диска, используемый в VMM, — это VHD-файл под управлением Windows, VHD-файл на основе Citrix XenServer или VMware-файл vmdk.

К свойствам, которые можно изменить, относятся:

  • Описание
  • Активировано
  • Имя
  • Операционная система
  • Владелец
  • SharePath

Файл виртуального жесткого диска может храниться в библиотеке VMM или подключиться к виртуальному диску на виртуальной машине или шаблоне.

Чтобы изменить параметры шины и LUN для виртуального диска, используйте командлет Set-SCVirtualDiskDrive .

Примеры

Пример 1. Изменение описания виртуального жесткого диска

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"

Первая команда извлекает объект виртуального жесткого диска с именем WindowsServer2003BootVHD.vhd из библиотеки в VMMServer01, а затем сохраняет объект в переменной $VHD.

Вторая команда изменяет описание объекта виртуального жесткого диска, хранящегося в $VHD на latest Windows Server 2008 R2 Boot VHD.

Пример 2. Включение виртуального жесткого диска на основе VMware в библиотеке

PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE

Первая команда получает объект виртуального жесткого диска с именем WindowsServer2008.vmdk, а затем сохраняет объект виртуального жесткого диска в переменной $VMDK.

Вторая команда отключает объект виртуального жесткого диска, хранящийся в $VMDK.

Пример 3. Указание владельца для всех виртуальных жестких дисков с владельцем Unknown

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

Эта команда получает все объекты виртуального жесткого диска из библиотеки VMM, владелец которой имеет значение "Неизвестно", а затем указывает владельца для каждого объекта виртуального жесткого диска.

Параметры

-Description

Задает описание объекта виртуального жесткого диска.

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

-Enabled

Включает объект, если задано значение $True, или отключает объект, если задано значение $False. Например, если вы хотите обновить программное обеспечение в шаблоне виртуальной машины, можно отключить объект шаблона в библиотеке VMM, чтобы временно запретить пользователям использовать этот объект.

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

-FamilyName

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

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

-JobGroup

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

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

-JobVariable

Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре.

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

-Name

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

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

-OperatingSystem

Указывает тип операционной системы для виртуальной машины. Чтобы получить список имен всех доступных операционных систем в VMM, введите Get-SCOperatingSystem.

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

-Owner

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

  • Пример формата: -Owner "Contoso\PattiFuller"
  • Пример формата: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

Указывает ключ продукта. Ключ продукта — это 25-значный номер, определяющий лицензию на продукт. Ключ продукта можно использовать для регистрации VMM или операционной системы для установки на виртуальной машине или узле.

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

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проводить аудит советов PRO.

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

-Release

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

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

-RunAsynchronously

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

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

-SharePath

Указывает путь к допустимой общей папке библиотеки на существующем сервере библиотеки, использующем UNC-путь.

Пример формата: -SharePath "\\LibServer01\LibShare"

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

-Tag

Задает слово или фразу для связи с объектом, чтобы можно было искать все объекты с указанным набором тегов. Можно найти подмножество тегов или найти полный набор тегов.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Указывает объект роли пользователя.

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

-VirtualHardDisk

Указывает объект виртуального жесткого диска.

Type:VirtualHardDisk
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualHardDisks

Задает массив объектов виртуального жесткого диска.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualizationPlatform

Указывает платформу виртуализации узла виртуальной машины, управляемого VMM. Допустимые значения для этого параметра:

  • HyperV
  • VMwareESX
  • Xenserver
Type:VirtualizationPlatform
Accepted values:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

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

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

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

VirtualHardDisk

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

Примечания

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