Set-SCGuestOSProfile

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

Синтаксис

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

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>]

Domain

Set-SCGuestOSProfile
    [-GuestOSProfile] <GuestOSProfile>
    -Domain <String>
    [-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]
    [-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>]

SSHKeyFile

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>]

SSHKeyString

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>]

Workgroup

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 изменяет одно или несколько свойств профиля гостевой операционной системы, используемого в среде диспетчера виртуальных машин (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.

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
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.

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

Тип:

System.Collections.Generic.Dictionary`2[System.String,System.String]

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

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

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

-UserRole

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

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

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

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

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

-Workgroup

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

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

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