Compartilhar via


New-SCGuestOSProfile

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 VMM (Virtual Machine Manager). 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 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 as configurações de perfil do 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 ao criar o perfil. Se você não especificar parâmetros exceto o parâmetro Name, o cmdlet New-SCGuestOSProfile criará um objeto de perfil do 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 a ser usado para ingressar uma máquina virtual em 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 Executar como chamado RunAsAccount01 e armazena o objeto na variável $DomainCredential.

O segundo comando obtém o objeto do sistema operacional denominado 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 Executar como especificada para ingressar a máquina virtual no domínio Contoso.com.

Observação: 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 porque 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 sistema operacional convidado chamado NewOSProfile02 e armazena o objeto na variável $OSProfile.

O segundo comando obtém o objeto do sistema operacional denominado 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 no NewOSProfile03 são idênticas às do NewOSProfile02.

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

Cuidado

Este artigo faz referência ao CentOS, uma distribuição do Linux que atingiu o status de EOL (Fim da Vida Útil). Considere seu uso e planejamento adequadamente. Para obter mais informações, consulte as diretrizes de fim de vida 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 Meu Perfil 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 a ser usado como um arquivo de resposta. O nome do script de 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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoLogonCredential

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

Tipo:RunAsAccount
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputerName

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

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome do NetBIOS
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableAutoLogon

Indica que esse cmdlet desabilita o logon de administrador automático.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Domain

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

Formato de exemplo: -Domain "Domain01.Corp.Contoso.com"

Tipo:String
Aliases:JoinDomain
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 limitada 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 especificar credenciais, em um modelo novo ou existente, em um perfil novo ou existente do sistema operacional convidado ou em uma nova máquina virtual, para ingressar uma máquina virtual no domínio.

Tipo:VMMCredential
Aliases:JoinDomainCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DomainJoinOrganizationalUnit

Especifica a unidade organizacional à qual o computador é ingressado durante uma mini-instalação autônoma.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FullName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GuestOSProfile

Especifica um objeto de perfil do sistema operacional convidado.

Tipo:GuestOSProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-GuiRunOnceCommands

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

Formato de exemplo: -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[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LinuxAdministratorSSHKey

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

Tipo:SSHKey
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LinuxAdministratorSSHKeyString

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LinuxDomainName

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

Formato de exemplo: -LinuxDomainName "Domain01.Corp.Contoso.com"

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LocalAdministratorCredential

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

Especificar credenciais em um modelo novo ou existente, em um perfil novo ou existente do sistema operacional convidado ou em uma nova máquina virtual substitui qualquer senha de Administrador existente.

Tipo:VMMCredential
Aliases:AdminPasswordCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MergeAnswerFile

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

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OrganizationName

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

Tipo:String
Aliases:OrgName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Owner

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

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 do produto pode ser usada para registrar o VMM ou um sistema operacional a ser instalado em uma máquina virtual ou host.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveDomainJoinOrganizationalUnit

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveServerFeatures

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Shielded

Indica se o objeto está protegido.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeZone

Especifica um número (um índice) que identifica uma região geográfica que compartilha o mesmo tempo padrão. Para obter uma lista de índices de fuso horário, consulte valores de índice de fuso horário da Microsoft 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.

Formato de exemplo para especificar o fuso horário padrão GMT: -TimeZone 085

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UnattendSettings

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

Tipo:System.Collections.Generic.Dictionary`2[System.String,System.String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserRole

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

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

GuestOSProfile

Esse cmdlet retorna um objeto GuestOSProfile.