Set-SCGuestOSProfile

Referência

Módulo:: VirtualMachineManager

Altera as propriedades de um perfil de sistema operacional convidado usado no VMM.

Sintaxe

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

Description

O cmdlet Set-SCGuestOSProfile altera uma ou mais propriedades de um perfil de sistema operacional convidado usado em um ambiente do Virtual Machine Manager (VMM). As alterações feitas em um perfil de sistema operacional convidado afetam apenas o próprio perfil do sistema operacional convidado. As alterações não afetam nenhuma máquina virtual existente que tenha sido criada anteriormente usando esse perfil.

Exemplos

Exemplo 1: Especificar um nome de organização para um perfil de sistema operacional convidado existente

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

O primeiro comando obtém o objeto de perfil do SO convidado chamado NewOSProfile01 e armazena o objeto na variável $OSProfile.

O segundo comando define Contoso como o nome da organização para o perfil do sistema operacional convidado armazenado no $OSProfile.

Exemplo 2: Especificar um SSHKey para um perfil de sistema operacional convidado Linux existente

Atenção

Este artigo faz referência ao CentOS, uma distribuição Linux que atingiu o status de Fim da Vida Útil (EOL). Por favor, considere o seu uso e planejamento de acordo. Para obter mais informações, consulte as diretrizes de Fim da Vida Útil do 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

O primeiro comando obtém o objeto de perfil do SO convidado chamado MyCentOSProfile e armazena o objeto na variável $OSProfile.

O segundo comando obtém o objeto SSHKey chamado My.Sshkey e armazena o objeto na variável $Sshkey.

O último comando define o objeto My.sshkey no perfil do sistema operacional convidado armazenado no $OSProfile.

Parâmetros

-AnswerFile

Especifica um objeto de script armazenado na biblioteca do VMM para usar como um arquivo de resposta. O nome do script do arquivo de resposta depende do sistema operacional que você deseja instalar em uma máquina virtual:

Sysprep.inf. Windows XP, Windows Server 2000 ou Windows Server 2003
Unattend.xml. Windows Vista, Windows 7 ou Windows Server 2008

Tipo:	Script
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-AutoLogonCount

Especifica o número de vezes que o Windows deve registrar automaticamente o administrador especificado no arquivo de resposta na sessão do console.

Tipo:	UInt32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AutoLogonCredential

Especifica a conta Run As contida no arquivo de resposta que o Windows usa para fazer logon na sessão do console quando o logon automático do administrador está habilitado.

Tipo:	RunAsAccount
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ComputerName

Especifica o nome de um computador que o VMM pode identificar exclusivamente na rede. Os valores aceitáveis para este parâmetro são:

FQDN
Endereço IPv4 ou IPv6
Nome NetBIOS

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DeploymentTypeNano

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Description

Especifica uma descrição para o perfil do sistema operacional convidado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableAutoLogon

Desabilita o logon automático do administrador.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Domain

Especifica um nome de domínio totalmente qualificado (FQDN) para um domínio do Ative Directory.

Exemplo de formato: -Domain "Domain01.Corp.Contoso.com"

Tipo:	String
Aliases:	JoinDomain
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DomainJoinCredential

Especifica o nome de usuário e a senha de uma conta que tem permissão para ingressar um computador no domínio. Recomendamos que você use uma conta de direitos limitados ingressando computadores no domínio. Isso inclui computadores virtuais e físicos.

Você pode usar o parâmetro atual para especificar credenciais em um VMHostProfile para ingressar um computador host físico no domínio, ou para especificar credenciais, em um modelo novo ou existente, em um perfil de sistema operacional convidado novo ou existente, ou em uma nova máquina virtual, para ingressar uma máquina virtual no domínio.

Tipo:	VMMCredential
Aliases:	JoinDomainCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DomainJoinOrganizationalUnit

Especifica a unidade organizacional à qual o computador está associado durante uma miniconfiguração autônoma.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-FullName

Especifica o nome da pessoa em cujo nome uma máquina virtual está registrada.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-GuestOSProfile

Especifica um objeto de perfil do sistema operacional convidado.

Tipo:	GuestOSProfile
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-GuiRunOnceCommands

Especifica uma matriz de comandos a serem adicionados à seção [GuiRunOnce] de um arquivo de resposta autônomo. Use aspas simples ao redor de cada cadeia de caracteres entre aspas duplas.

Exemplo de formato: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Para obter informações sobre como o Windows PowerShell usa aspas, digite Get-Help about_Quoting_Rules.

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-LinuxAdministratorSSHKey

Especifica o arquivo de chave pública para uma chave SSH do Linux.

Tipo:	SSHKey
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-LinuxAdministratorSSHKeyString

Especifica uma chave SSH de administrador do Linux como uma cadeia de caracteres.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-LinuxDomainName

Especifica um nome de domínio totalmente qualificado (FQDN) para usar em conjunto com a especialização do sistema operacional Linux.

Exemplo de formato: -LinuxDomainName "Domain01.Corp.Contoso.com"

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-LocalAdministratorCredential

Especifica o nome de usuário e a senha para a conta de Administrador Local (ou conta raiz Linux no caso de um perfil de sistema operacional convidado compatível com Linux).

A especificação de credenciais em um modelo novo ou existente, em um perfil de sistema operacional convidado novo ou existente ou em uma nova máquina virtual substitui qualquer senha de Administrador existente.

Tipo:	VMMCredential
Aliases:	AdminPasswordCredential
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-MergeAnswerFile

Indica se esse cmdlet mescla o arquivo de resposta com as configurações do sistema operacional convidado. O valor padrão é $True. O console do VMM usa esse parâmetro. Não especifique este parâmetro.

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

Especifica o nome de um objeto do VMM.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-OperatingSystem

Especifica o tipo de sistema operacional para uma máquina virtual.

Para obter os nomes de todos os sistemas operacionais disponíveis no VMM, digite Get-SCOperatingSystem.

Tipo:	OperatingSystem
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-OrganizationName

Especifica o nome da organização para a pessoa em cujo nome uma máquina virtual está registrada.

Tipo:	String
Aliases:	OrgName
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Owner

Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válida.

Exemplo de formato: -Owner "Contoso\PattiFuller"
Exemplo de formato: -Owner "PattiFuller@Contoso"

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ProductKey

Especifica uma chave do produto. A chave do produto é um número de 25 dígitos que identifica a licença do produto. Uma chave de produto pode ser usada para registrar o VMM ou um sistema operacional a ser instalado em uma máquina virtual ou host.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:	Guid
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RemoveDomainJoinOrganizationalUnit

Indica que esse cmdlet remove a unidade organizacional à qual o computador ingressou durante a instalação.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RemoveServerFeatures

Indica que esse cmdlet remove todas as funções e recursos de servidor de um modelo.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Shielded

Indica se o objeto está blindado.

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-TimeZone

Especifica um número (um índice) que identifica uma região geográfica que compartilha a mesma hora padrão. Para obter uma lista de índices de fuso horário, consulte Microsoft Time Zone Index Values em http://go.microsoft.com/fwlink/?LinkId=120935. Se nenhum fuso horário for especificado, o fuso horário padrão usado para uma máquina virtual será a mesma configuração de fuso horário que está no host da máquina virtual.

Exemplo de formato para especificar o fuso horário padrão GMT: -TimeZone 085

Tipo:	Int32
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UnattendSettings

Especifica um par chave/valor que consiste em String, String.

Tipo:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UserRole

Especifica um objeto de função de usuário.

Tipo:	UserRole
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Workgroup

Especifica em um modelo novo ou existente, em um perfil de sistema operacional convidado novo ou existente ou em uma nova máquina virtual o nome do grupo de trabalho ao qual você deseja ingressar em uma máquina virtual. Você pode usar esse parâmetro para substituir o valor existente em um modelo ou em um perfil de sistema operacional convidado.

Tipo:	String
Aliases:	JoinWorkgroup
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Saídas

GuestOSProfile

Este cmdlet retorna um objeto GuestOSProfile.

Notas

Requer um objeto de perfil do SO convidado do VMM, que pode ser recuperado usando o cmdlet Get-SCGuestOSProfile .

Partilhar via