New-SCGuestOSProfile

  • Referência
Módulo:
VirtualMachineManager

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

Syntax

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 do 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 do 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 autônomo do sistema operacional convidado ou personalizar um modelo ou uma 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 do sistema operacional convidado com base em configurações padrão, com base em um perfil de sistema operacional convidado existente, ou personalizar as configurações à medida que cria 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 padrão do sistema operacional convidado

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

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 Meu Perfil CentOS 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
Type:Script
Aliases:SysPrepFile
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 automático do administrador está habilitado.

Type:RunAsAccount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

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

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoLogon

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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"

Type:String
Aliases:JoinDomain
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 que ingresse 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 de sistema operacional convidado novo ou existente, ou em uma nova máquina virtual, para ingressar uma máquina virtual no domínio.

Type:VMMCredential
Aliases:JoinDomainCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainJoinOrganizationalUnit

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GuestOSProfile

Especifica um objeto de perfil do sistema operacional convidado.

Type:GuestOSProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 Windows PowerShell usa aspas, digite Get-Help about_Quoting_Rules.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LinuxAdministratorSSHKey

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

Type:SSHKey
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LinuxAdministratorSSHKeyString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalAdministratorCredential

Especifica o nome de usuário e a senha da conta do 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.

Type:VMMCredential
Aliases:AdminPasswordCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 esse parâmetro.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um objeto VMM.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystem

Especifica o tipo de sistema operacional de uma máquina virtual. Para obter os nomes de todos os sistemas operacionais disponíveis no VMM, digite Get-SCOperatingSystem.

Type:OperatingSystem
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OrganizationName

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

Type:String
Aliases:OrgName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

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

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveDomainJoinOrganizationalUnit

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveServerFeatures

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Shielded

Indica se o objeto está protegido.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 os 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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnattendSettings

Especifica um par chave/valor que consiste em Cadeia de Caracteres, Cadeia de Caracteres.

Type:System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

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

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor do VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 do sistema operacional convidado.

Type:String
Aliases:JoinWorkgroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

GuestOSProfile

Este cmdlet retorna um objeto GuestOSProfile .