Set-SCVMHostProfile

Модуль:: VirtualMachineManager Module

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

Синтаксис

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

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
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

(All)

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

-Baseline

Задает массив объектов Baseline .

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

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

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

(All)

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

-BypassVHDConversion

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

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

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

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

(All)

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

-CodeIntegrityPolicy

Указывает политику целостности кода.

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

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

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

(All)

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

-ComputerAccessRunAsAccount

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

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

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

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

(All)

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

-Description

Задает описание для профиля узла сети.

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

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

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

(All)

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

-DiskConfiguration

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

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

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

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

(All)

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

-Domain

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

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

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

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

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

(All)

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

-DomainJoinRunAsAccount

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

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

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

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

(All)

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

-DriverMatchingTag

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

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

Тип:	System.Collections.Generic.List`1[System.String]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

(All)

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

-FullName

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

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

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

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

(All)

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

-GuiRunOnceCommands

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

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

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

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

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

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

(All)

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

-IsGuarded

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

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

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

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

(All)

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

-JobGroup

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

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

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

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

(All)

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

-JobVariable

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

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

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

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

(All)

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

-LocalAdministratorCredential

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

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

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

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

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

(All)

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

-Name

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

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

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

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

(All)

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

-OrganizationName

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

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

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

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

(All)

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

-Owner

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

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

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

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

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

(All)

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

-ProductKey

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

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

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

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

(All)

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

-PROTipID

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

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

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

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

(All)

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

-RemoveAnswerFile

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

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

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

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

(All)

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

-RemoveGuiRunOnceCommands

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

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

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

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

(All)

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

-RunAsynchronously

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

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

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

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

(All)

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

-TimeZone

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

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

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

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

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

(All)

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

-VirtualHardDisk

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

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

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

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

(All)

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

-VMHostNetworkAdapterProfile

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

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

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

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

(All)

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

-VMHostProfile

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

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

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

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

(All)

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

-VMMServer

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

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

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

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

(All)

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

-VMPaths

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

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

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

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

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

(All)

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

CommonParameters

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

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

HostProfile

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