New-SCGuestOSProfile

Módulo:

VirtualMachineManager

Cria um perfil de sistema operacional convidado para uso no VMM.

Sintaxe

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

Description

O cmdlet New-SCGuestOSProfile cria um perfil de sistema operacional convidado para uso no Virtual Machine Manager (VMM). Um sistema operacional convidado é o sistema operacional em uma máquina virtual, em contraste com um sistema operacional host que está no computador host físico no qual uma ou mais máquinas virtuais são implantadas.

Um perfil de sistema operacional convidado armazena informações de configuração do sistema operacional. Um perfil consiste em um conjunto de propriedades que contêm as configurações mais comuns especificadas em um arquivo de resposta autônomo (como um arquivo Sysprep.inf ou um arquivo Unattend.xml).

Você pode criar um perfil de sistema operacional convidado autônomo ou personalizar um modelo ou máquina virtual para incluir configurações de perfil de sistema operacional convidado. O cmdlet New-SCGuestOSProfile armazena o novo objeto de perfil do sistema operacional convidado na biblioteca do VMM.

Você pode criar um perfil de sistema operacional convidado com base nas configurações padrão, com base em um perfil de sistema operacional convidado existente ou pode personalizar as configurações à medida que cria o perfil. Se você não especificar nenhum parâmetro, exceto o parâmetro Name, o cmdlet New-SCGuestOSProfile criará um objeto de perfil de sistema operacional convidado padrão.

Exemplos

Exemplo 1: Criar um perfil de sistema operacional convidado padrão

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

O primeiro comando obtém o objeto do sistema operacional chamado "edição de 64 bits do Windows Server 2008 R2 Enterprise" do VMMServer01 e armazena o objeto na variável $OS.

O segundo comando cria um perfil de sistema operacional convidado padrão chamado NewProfile01 e especifica o nome do sistema operacional.

Exemplo 2: Criar um perfil de sistema operacional convidado para usar para associar uma máquina virtual a um domínio

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

O primeiro comando obtém o objeto de conta Run As chamado RunAsAccount01 e armazena o objeto na variável $DomainCredential.

O segundo comando obtém o objeto do sistema operacional chamado edição de 64 bits do Windows Server 2008 R2 Enterprise do VMMServer01 e armazena o objeto na variável $OS.

O último comando cria um perfil de sistema operacional convidado chamado NewOSProfile02 e especifica o nome do sistema operacional. Quando você usa NewOSProfile02 para criar uma máquina virtual, o perfil usa a conta Run As especificada para associar a máquina virtual ao domínio Contoso.com.

Nota: Se você fornecer um objeto PSCredential em vez de uma conta RunAs para o parâmetro DomainJoinCredential, é recomendável usar apenas uma conta com direitos limitados para ingressar automaticamente uma máquina virtual em um domínio, pois o nome da conta de domínio e a senha aparecem brevemente em texto sem formatação no servidor host.

Exemplo 3: clonar um perfil de sistema operacional convidado existente

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

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

O segundo comando obtém o objeto do sistema operacional chamado edição de 64 bits do Windows Server 2008 R2 Datacenter e armazena o objeto na variável $OS.

O último comando cria o perfil do sistema operacional convidado chamado NewOSProfile03, que é baseado em NewOSProfile02, mas modifica o nome do computador e especifica um nome diferente para o sistema operacional. Todas as outras configurações em NewOSProfile03 são idênticas às de NewOSProfile02.

Exemplo 4: Criar um perfil de sistema operacional convidado Linux e definir o nome de domínio DNS do Linux

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:\> $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

O primeiro comando obtém o objeto do sistema operacional chamado CentOS Linux 6 (64 bits) do VMMServer01 e armazena o objeto na variável $OS.

O segundo comando cria um perfil de sistema operacional convidado chamado My CentOS Profile e especifica o nome do sistema operacional e o nome de domínio DNS do Linux. Quando você usa o perfil My CentOS para criar uma máquina virtual, o perfil usa o nome de domínio DNS do Linux especificado.

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

{{Fill DeploymentTypeNano Description}}

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

Indica que esse cmdlet 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:	Named
Default value:	None
Necessário:	False
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:	0
Default value:	None
Necessário:	True
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

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:	ServerConnection
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
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.

Ligações Relacionadas

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