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

Set-SCVMHostProfile

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

Изменяет свойства профиля узла.

Синтаксис

Set-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [[-Name] <String>]
   [-VirtualHardDisk <VirtualHardDisk>]
   [-Domain <String>]
   [-DomainJoinRunAsAccount <RunAsAccount>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-RemoveAnswerFile]
   [-RemoveGuiRunOnceCommands]
   [-Description <String>]
   [-Owner <String>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-AnswerFile <Script>]
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Описание

Командлет Set-SCVMHostProfile изменяет свойства профиля узла.

Сведения о создании профиля узла введите Get-Help New-SCVMHostProfile -Detailed.

Примеры

Пример 1. Установка значения часового пояса для указанного профиля узла

PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035

Эта команда получает объект профиля узла с именем HostProfile01 и задает значение часового пояса для часового пояса США (035).

Пример 2. Добавление профиля сетевого адаптера узла в профиль узла

PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf

Первая команда получает объект профиля узла с именем HostProfile01 и сохраняет объект в переменной $VMHostProfile.

Вторая команда получает объект профиля сетевого адаптера узла с идентификатором 259f47c7-c5a9-429d-a421-d232f9b34991 и сохраняет объект в переменной $HostNetAdapterProf.

Последняя команда добавляет профиль сетевого адаптера узла, хранящийся в $HostNetAdapterProf в HostProfile01.

Параметры

-AnswerFile

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

  • Sysprep.inf. Windows XP, Windows Server 2000 или Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 или Windows Server 2008
Тип:Script
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Baseline

Задает массив объектов Базовых.

Тип:Baseline[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BypassVHDConversion

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CodeIntegrityPolicy

Задает политику целостности кода.

Тип:CodeIntegrityPolicy
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ComputerAccessRunAsAccount

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

Тип:RunAsAccount
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Указывает описание профиля узла.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DiskConfiguration

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Domain

Указывает полное доменное имя (FQDN) для домена Active Directory.

Пример формата: -Domain "Domain01.Corp.Contoso.com"

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DomainJoinRunAsAccount

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

Тип:RunAsAccount
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DriverMatchingTag

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

Тип:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FullName

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-GuiRunOnceCommands

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

Пример формата: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Сведения о том, как Windows PowerShell использует кавычки, введите Get-Help about_Quoting_Rules.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IsGuarded

Указывает, что узел должен быть защищенным узлом.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobGroup

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

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobVariable

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LocalAdministratorCredential

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

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

Тип:VMMCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

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

Тип:String
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OrganizationName

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Owner

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

  • Пример формата: -Owner "Contoso\PattiFuller"
  • Пример формата: -Owner "PattiFuller@Contoso"
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ProductKey

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PROTipID

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

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveAnswerFile

Указывает, что эта операция удаляет файл ответа из профиля узла.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveGuiRunOnceCommands

Indiates, что эта операция удаляет свойство GUI Run Once Commands из профиля узла.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-TimeZone

Указывает число (индекс), определяющее географический регион, который использует одно и то же стандартное время. Список индексов часовых поясов см. в разделе Значения индексов часового пояса Майкрософт по http://go.microsoft.com/fwlink/?LinkId=120935. Если часовой пояс не указан, часовой пояс по умолчанию, используемый для виртуальной машины, совпадает с параметром часового пояса, который находится на узле виртуальной машины.

Пример формата для указания часового пояса GMT standard: -TimeZone 085

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VirtualHardDisk

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

Тип:VirtualHardDisk
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMHostNetworkAdapterProfile

Задает массив объектов профиля сетевого адаптера узла.

Тип:PhysicalComputerNetworkAdapterProfile[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMHostProfile

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

Тип:PhysicalComputerProfile
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VMMServer

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

Тип:ServerConnection
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VMPaths

Задает набор путей по умолчанию (как строки, разделенные оператором конвейера) на узле, где могут храниться файлы виртуальной машины.

Пример формата: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

HostProfile[]

Этот командлет возвращает один или несколько объектов HostProfile.