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

Set-SCGuestOSProfile

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

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

Синтаксис

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

Описание

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

Примеры

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

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -OrgName "Contoso"

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

Вторая команда задает Contoso в качестве имени организации для профиля гостевой операционной системы, хранящегося в $OSProfile.

Пример 2. Указание SSHKey для существующего профиля гостевой операционной системы Linux

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

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

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

Первая команда получает объект профиля гостевой ОС с именем 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
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:0
Default value:None
Обязательно:True
Принять входные данные конвейера: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:Named
Default value:None
Обязательно:False
Принять входные данные конвейера: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

-Workgroup

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

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

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

GuestOSProfile

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

Примечания

  • Требуется объект профиля гостевой ОС VMM, который можно получить с помощью командлет а Get-SCGuestOSProfile.