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

New-SCVMHostProfile

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

Создает профиль узла.

Синтаксис

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

Описание

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

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

Примеры

Пример 1. Создание профиля узла

PS C:\> $VHD = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> $RunAsAcct = Get-SCRunAsAccount -Name "RunAsAcct01"
PS C:\> $Credential = Get-Credential
PS C:\> $HostProfile = New-SCVMHostProfile -Name "HostProfile01" -Owner "Contoso\Katarina" -Description "Host Profile 01" -Domain "Contoso.com" -DomainJoinRunAsAccount $RunAsAcct -VirtualHardDisk $VHD -LocalAdministratorCredential $Credential
PS C:\> $HostProfile

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

Вторая команда запрашивает учетные данные. В командной строке введите учетные данные учетной записи администратора. Команда сохраняет учетные данные в переменной $Credential.

Третья команда создает профиль узла с именем HostProfile01 с помощью виртуального жесткого диска, хранящегося в $VHD, и учетные данные, хранящиеся в $Credential.

Последняя команда отображает сведения о созданном профиле узла пользователю.

Пример 2. Клонирование существующего профиля узла

PS C:\> $OrigHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $NewHostProfile = New-SCVMHostProfile -Name "HostProfile02" -VMHostProfile $OrigHostProfile

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

Вторая команда копирует профиль узла, хранящийся в $OrigHostProfile, присваивает ему указанное имя и сохраняет новый объект профиля в переменной $NewHostProfile.

Пример 3. Создание профиля узла, включающего профиль сетевого адаптера узла

PS C:\> $VHDX = Get-SCVirtualHardDisk -Name "VHDX01.vhdx"
PS C:\> $DomainJoinCreds = Get-SCRunAsAccount -Name "DomainJoinRAA"
PS C:\> $LocalAdminCreds = Get-Credential
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> New-SCVMHostProfile -Name "HostProfile03" -Owner "Contoso\Katarina" -Description "Host Profile 03" -Domain "Contoso.com" -DomainJoinRunAsAccount $DomainJoinCreds -VirtualHardDisk $VHDX -LocalAdministratorCredential $LocalAdminCreds -VMHostNetworkAdapterProfile $HostNetAdapterProf

Первая команда получает объект виртуального жесткого диска с именем VHDX01.vhdx и сохраняет объект в переменной $VHDX.

Вторая команда получает объект учетной записи запуска от имени с именем DomainJoinRAA и сохраняет объект в переменной $DomainJoinCreds.

Третья команда запрашивает у пользователя учетные данные локального администратора и сохраняет предоставленные учетные данные в переменной $LocalAdminCreds.

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

Последняя команда создает профиль узла с именем Host Profile 03 с помощью VHDX01 и профиля сетевого адаптера узла, хранящегося в $HostNetAdapterProf.

Параметры

-AnswerFile

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

  • Sysprep.inf. Windows XP, Windows Server 2000 или Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 или Windows Server 2008
Type:Script
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Baseline

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

Type:Baseline[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BypassVHDConversion

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

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

-CodeIntegrityPolicy

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

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

-ComputerAccessRunAsAccount

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

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

-Description

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

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

-DiskConfiguration

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

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

-Domain

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

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

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

-DomainJoinRunAsAccount

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

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

-DriverMatchingTag

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

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

-FullName

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

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

-GuiRunOnceCommands

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

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

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

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

-IsGuarded

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

Type:Boolean
Position:Named
Default value:None
Required:False
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

-JoinWorkgroup

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

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

-LocalAdministratorCredential

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

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

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

-Name

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

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

-OrganizationName

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

Type:String
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

-RunAsynchronously

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

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

-TimeZone

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

Пример формата для указания часового пояса GMT (цен. категория "Стандартный") -TimeZone 085

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

-VirtualHardDisk

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

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

-VMHostNetworkAdapterProfile

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

Type:PhysicalComputerNetworkAdapterProfile[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostProfile

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

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

-VMMServer

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

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

-VMPaths

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

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

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

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

HostProfile

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