New-SCGuestOSProfile

Модуль:

VirtualMachineManager

Создает профиль гостевой операционной системы для использования в VMM.

Синтаксис

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   -Domain <String>
   [-DeploymentTypeNano <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Workgroup <String>]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Описание

Командлет New-SCGuestOSProfile создает профиль гостевой операционной системы для использования в Virtual Machine Manager (VMM). Гостевая операционная система — это операционная система на виртуальной машине, в отличие от операционной системы узла, которая находится на физическом компьютере узла, на котором развертываются одна или несколько виртуальных машин.

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

Можно создать автономный профиль гостевой операционной системы или настроить шаблон или виртуальную машину для включения параметров профиля гостевой операционной системы. Командлет New-SCGuestOSProfile сохраняет новый объект профиля гостевой операционной системы в библиотеке VMM.

Вы можете создать профиль гостевой операционной системы на основе параметров по умолчанию на основе существующего профиля гостевой операционной системы или настроить параметры при создании профиля. Если параметры не указаны, кроме параметра Name, командлет New-SCGuestOSProfile создает объект профиля гостевой операционной системы по умолчанию.

Примеры

Пример 1. Создание профиля гостевой операционной системы по умолчанию

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile01" -OperatingSystem $OS

Первая команда получает объект операционной системы с именем "64-разрядная версия Windows Server 2008 R2 Enterprise" из VMMServer01 и сохраняет объект в переменной $OS.

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

Пример 2. Создание профиля гостевой операционной системы для присоединения виртуальной машины к домену

PS C:\> $DomainCredential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile02" -JoinDomain "Contoso.com" -DomainJoinCredential $DomainCredential -OperatingSystem $OS

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

Вторая команда получает объект операционной системы с именем 64-разрядного выпуска Windows Server 2008 R2 Enterprise из VMMServer01 и сохраняет объект в переменной $OS.

Последняя команда создает профиль гостевой операционной системы с именем NewOSProfile02 и указывает имя операционной системы. При использовании NewOSProfile02 для создания виртуальной машины профиль использует указанную учетную запись запуска от имени для присоединения виртуальной машины к домену Contoso.com.

Примечание. Если вы предоставляете объект PSCredential вместо учетной записи RunAs для параметра DomainJoinCredential, рекомендуется использовать только учетную запись с ограниченными правами на автоматическое присоединение виртуальной машины к домену, так как имя учетной записи домена и пароль отображаются кратко в виде обычного текста на сервере узла.

Пример 3. Клонирование существующего профиля гостевой операционной системы

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile02"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile03" -GuestOSProfile $OSProfile -ComputerName "Contoso03" -OperatingSystem $OS

Первая команда получает объект профиля гостевой ОС с именем NewOSProfile02 и сохраняет объект в переменной $OSProfile.

Вторая команда получает объект операционной системы с именем 64-разрядного выпуска Windows Server 2008 R2 Datacenter и сохраняет объект в переменной $OS.

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

Пример 4. Создание профиля гостевой операционной системы Linux и задание доменного имени DNS Linux

Осторожность

Эта статья ссылается на CentOS, дистрибутив Linux, который достиг состояния окончания жизни (EOL). Пожалуйста, рассмотрите возможность использования и планирования соответствующим образом. Дополнительные сведения см. вCentOS End Of Life.

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "CentOS Linux 6 (64 bit)"} 
PS C:\> New-SCGuestOSProfile -Name "My CentOS Profile" -LinuxDomainName "contoso.com" -OperatingSystem $os

Первая команда получает объект операционной системы с именем CentOS Linux 6 (64-разрядная версия) из VMMServer01 и сохраняет объект в переменной $OS.

Вторая команда создает профиль гостевой операционной системы с именем My CentOS Profile и указывает имя операционной системы и доменное имя DNS Linux. При использовании профиля My CentOS для создания виртуальной машины профиль использует указанное доменное имя DNS Linux.

Параметры

-AnswerFile

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

• Sysprep.inf. Windows XP, Windows Server 2000 или Windows Server 2003
• Unattend.xml. Windows Vista, Windows 7 или Windows Server 2008

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

-AutoLogonCount

Указывает количество случаев, когда Windows автоматически регистрирует администратора, указанного в файле ответа на сеанс консоли.

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

-AutoLogonCredential

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

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

-ComputerName

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

• Полное доменное имя
• IPv4 или IPv6-адрес
• Имя NetBIOS

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

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

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

-Description

Указывает описание профиля гостевой операционной системы.

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

-DisableAutoLogon

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

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

-Domain

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

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

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

-DomainJoinCredential

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

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

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

-DomainJoinOrganizationalUnit

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

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

-FullName

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

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

-GuestOSProfile

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

Тип:	GuestOSProfile
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	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

-JobVariable

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

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

-LinuxAdministratorSSHKey

Указывает файл открытого ключа для ключа SSH Linux.

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

-LinuxAdministratorSSHKeyString

Указывает ключ SSH администратора Linux в виде строки.

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

-LinuxDomainName

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

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

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

-LocalAdministratorCredential

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

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

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

-MergeAnswerFile

Указывает, объединяет ли этот командлет файл ответа вместе с параметрами гостевой операционной системы. Значение по умолчанию — $True. Консоль VMM использует этот параметр. Не указывайте этот параметр.

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

-Name

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

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

-OperatingSystem

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

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

-OrganizationName

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

Тип:	String
Aliases:	OrgName
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

-RemoveDomainJoinOrganizationalUnit

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

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

-RemoveServerFeatures

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

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

-RunAsynchronously

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

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

-Shielded

Указывает, экранируется ли объект.

Тип:	Boolean
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

-UnattendSettings

Указывает пару "ключ-значение", состоящую из String, String.

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

-UserRole

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

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

-VMMServer

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

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

-Workgroup

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

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

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

GuestOSProfile

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

Связанные ссылки

• Get-SCGuestOSProfile
• Get-SCOperatingSystem
• Get-SCRunAsAccount
• Remove-SCGuestOSProfile
• Set-SCGuestOSProfile