Set-SCGuestOSProfile
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 VMM (Virtual Machine Manager). As alterações feitas em um perfil do sistema operacional convidado afetam apenas o próprio perfil do sistema operacional convidado. As alterações não afetam as máquinas virtuais existentes que foram criadas 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 sistema operacional 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 em $OSProfile.
Exemplo 2: Especificar um SSHKey para um perfil de sistema operacional convidado do Linux existente
Cuidado
Este artigo faz referência ao CentOS, uma distribuição do Linux que atingiu o status de EOL (Fim do serviço). Considere seu uso e planejamento adequadamente. Para obter mais informações, veja as Orientações sobre 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 $SshkeyO primeiro comando obtém o objeto de perfil do sistema operacional 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 em $OSProfile.
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
Desabilita o logon do 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: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| 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: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| 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 |
-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.
Observações
- Requer um objeto de perfil do so convidado do VMM, que pode ser recuperado usando o cmdlet Get-SCGuestOSProfile
.