Командлет Set-SCGuestOSProfile изменяет одно или несколько свойств профиля гостевой операционной системы, используемого в среде диспетчера виртуальных машин (VMM).
Изменения, внесенные в профиль гостевой операционной системы, влияют только на сам профиль гостевой операционной системы.
Изменения не затрагивают существующие виртуальные машины, которые были ранее созданы с помощью этого профиля.
Примеры
Пример 1: Укажите название организации для существующего профиля гостевой операционной системы
Первая команда получает объект профиля гостевой ОС с именем NewOSProfile01 и сохраняет объект в переменной $OSProfile.
Вторая команда задает Contoso в качестве имени организации для профиля гостевой операционной системы, хранящегося в $OSProfile.
Пример 2: Указание SSHKey для существующего профиля гостевой операционной системы Linux
Осторожность
Эта статья ссылается на CentOS, дистрибутив Linux, который достиг состояния окончания жизни (EOL). Пожалуйста, рассмотрите возможность использования и планирования соответствующим образом. Для получения дополнительной информации смотрите руководство по окончанию поддержки CentOS.
Первая команда получает объект профиля гостевой ОС с именем MyCentOSProfile и сохраняет объект в переменной $OSProfile.
Вторая команда получает объект SSHKey с именем My.Sshkey и сохраняет объект в переменной $Sshkey.
Последняя команда устанавливает объект My.sshkey в профиле гостевой операционной системы, хранящемся в $OSProfile.
Параметры
-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
Aliases:
Файл SysPrepFile
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
True
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-AutoLogonCount
Указывает количество случаев, когда Windows автоматически регистрирует администратора, указанного в файле ответа на сеанс консоли.
Свойства параметра
Тип:
UInt32
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-AutoLogonCredential
Указывает учетную запись запуска от имени, содержащуюся в файле ответа, который Windows использует для входа в сеанс консоли при включенном автоматическом входе администратора.
Свойства параметра
Тип:
RunAsAccount
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-ComputerName
Указывает имя компьютера, который VMM может однозначно идентифицировать в сети.
Допустимые значения для этого параметра:
Полное доменное имя (FQDN)
IPv4 или IPv6-адрес
Имя NetBIOS
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-DeploymentTypeNano
{{Заполните описание DeploymentTypeNano}}
Свойства параметра
Тип:
Boolean
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
Domain
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-Description
Указывает описание для профиля гостевой операционной системы.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-DisableAutoLogon
Отключает автоматический вход администратора.
Свойства параметра
Тип:
SwitchParameter
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
Aliases:
JoinDomain
Наборы параметров
Domain
Position:
Named
Обязательно:
True
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-DomainJoinCredential
Указывает имя пользователя и пароль учетной записи, которая имеет разрешение на присоединение компьютера к домену.
Рекомендуется использовать учетную запись с ограниченными правами, присоединенную к домену.
Это включает виртуальные и физические компьютеры.
Текущий параметр можно использовать для указания учетных данных в VMHostProfile для присоединения физического компьютера узла к домену или указания учетных данных в новом или существующем шаблоне, в новом или существующем профиле гостевой операционной системы или на новой виртуальной машине для присоединения виртуальной машины к домену.
Свойства параметра
Тип:
VMMCredential
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Aliases:
JoinDomainCredential (JoinDomainCredential)
Наборы параметров
Domain
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-DomainJoinOrganizationalUnit
Указывает подразделение, к которому присоединен компьютер во время автоматической мини-установки.
Свойства параметра
Тип:
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
-GuestOSProfile
Указывает объект профиля гостевой операционной системы.
Свойства параметра
Тип:
GuestOSProfile
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
0
Обязательно:
True
Значение из конвейера:
True
Значение из конвейера по имени свойства:
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
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-LinuxAdministratorSSHKey
Указывает файл открытого ключа для ключа SSH Linux.
Свойства параметра
Тип:
SSHKey
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
SSHKeyFile
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-LinuxAdministratorSSHKeyString
Указывает ключ SSH администратора Linux в виде строки.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
SSHKeyString
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-LinuxDomainName
Указывает полное доменное имя (FQDN) для использования в сочетании со специализацией операционной системы Linux.
Пример формата: -LinuxDomainName "Domain01.Corp.Contoso.com"
Свойства параметра
Тип:
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
Aliases:
AdminPasswordCredential
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-MergeAnswerFile
Указывает, объединяет ли этот командлет файл ответа вместе с параметрами гостевой операционной системы.
Значение по умолчанию — $True.
Консоль VMM использует этот параметр.
Не указывайте этот параметр.
Свойства параметра
Тип:
Boolean
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-Name
Указывает имя объекта VMM.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-OperatingSystem
Указывает тип операционной системы для виртуальной машины.
Чтобы получить имена всех доступных операционных систем в VMM, введите Get-SCOperatingSystem.
Свойства параметра
Тип:
OperatingSystem
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-OrganizationName
Указывает имя организации для пользователя, имя которого зарегистрирована виртуальная машина.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Aliases:
OrgName
Наборы параметров
(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
-RemoveDomainJoinOrganizationalUnit
Указывает, что этот командлет удаляет организационную единицу, к которой компьютер присоединился во время настройки.
Свойства параметра
Тип:
SwitchParameter
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Наборы параметров
(All)
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
-RemoveServerFeatures
Указывает, что этот командлет удаляет все серверные роли и функции из шаблона.
Свойства параметра
Тип:
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
-Shielded
Указывает, экранируется ли объект.
Свойства параметра
Тип:
Boolean
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
-UnattendSettings
Указывает пару "ключ-значение", состоящую из String, String.
Указывает новый или существующий шаблон, на новом или существующем профиле гостевой операционной системы или на новой виртуальной машине имя рабочей группы, к которой требуется присоединиться к виртуальной машине.
Этот параметр можно использовать для переопределения существующего значения на шаблоне или в профиле гостевой операционной системы.
Свойства параметра
Тип:
String
Default value:
None
Поддерживаются подстановочные знаки:
False
DontShow:
False
Aliases:
JoinWorkgroup
Наборы параметров
Workgroup
Position:
Named
Обязательно:
False
Значение из конвейера:
False
Значение из конвейера по имени свойства:
False
Значение из оставшихся аргументов:
False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Выходные данные
GuestOSProfile
Этот командлет возвращает объект GuestOSProfile .
Примечания
Требуется объект профиля гостевой ОС VMM, который можно получить с помощью командлета Get-SCGuestOSProfile .