Set-SCVirtualHardDisk

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

Синтаксис

Default

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

EquivalencySet

Set-SCVirtualHardDisk
    [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
    -FamilyName <String>
    -Release <String>
    [-VMMServer <ServerConnection>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Описание

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

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

  • Описание
  • Включен
  • Имя
  • Операционная система
  • Владелец
  • 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: Укажите владельца для всех виртуальных жестких дисков с "Неизвестным" владельцем

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

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

Параметры

-Description

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

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

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

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

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

-Enabled

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

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

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

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

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

-FamilyName

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

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

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

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

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

-JobGroup

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

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

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

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

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

-JobVariable

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

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

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

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

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

-Name

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

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

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

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

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

-OperatingSystem

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

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

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

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

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

-Owner

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

  • Пример формата: -Owner "Contoso\PattiFuller"
  • Пример формата: -Owner "PattiFuller@Contoso"

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

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

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

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

-ProductKey

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

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

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

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

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

-PROTipID

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

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

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

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

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

-Release

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

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

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

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

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

-RunAsynchronously

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

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

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

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

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

-SharePath

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

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

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

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

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

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

-Tag

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

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

Тип:

System.Collections.Generic.List`1[System.String]

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

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

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

-UserRole

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

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

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

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

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

-VirtualHardDisk

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

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

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

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

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

-VirtualHardDisks

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

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

Тип:

System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]

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

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

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

-VirtualizationPlatform

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

  • ГиперВ
  • VMwareESX
  • XENServer

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

Тип:VirtualizationPlatform
Default value:None
Допустимые значения:Unknown, VirtualServer, HyperV, VMwareVC, VMwareESX, XENServer
Поддерживаются подстановочные знаки:False
DontShow:False

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

Default
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства: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.

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

VirtualHardDisk

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

Примечания

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