New-SCVMConfiguration
Cria uma configuração de máquina virtual a partir de um modelo de máquina virtual.
Sintaxe
New-SCVMConfiguration
-VMTemplate <Template>
[-Name <String>]
[-Description <String>]
[-CostCenter <String>]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVMConfiguration
-VMTemplate <Template>
-Name <String>
[-Description <String>]
-Cloud <Cloud>
[-CostCenter <String>]
[-CapabilityProfile <CapabilityProfile>]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVMConfiguration
-VMTemplate <Template>
-Name <String>
[-Description <String>]
-VMHostGroup <HostGroup>
[-CostCenter <String>]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVMConfiguration
-ComputerTier <ComputerTier>
[-Name <String>]
[-Description <String>]
[-CostCenter <String>]
[-ComputerName <String>]
[-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
O cmdlet New-SCVMConfiguration cria uma configuração de máquina virtual a partir de um modelo de máquina virtual. A configuração da máquina virtual é usada para especificar valores específicos de instância a serem usados ao implantar a configuração da máquina virtual.
Exemplos
Exemplo 1: criar uma configuração de máquina virtual para posicionamento de uma máquina virtual em um grupo de hosts
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "Production"
PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $VMConfig = New-SCVMConfiguration -VMTemplate $VMTemplate -VMHostGroup $HostGroup -CostCenter 1234 -Name "VMConfig01"
O primeiro comando obtém o objeto de grupo de host chamado Produção e armazena o objeto na variável $HostGroup.
O segundo comando obtém todos os objetos de modelo de máquina virtual, seleciona o modelo chamado VMTemplate01 e armazena o objeto na variável $VMTemplate.
O último comando cria uma configuração de máquina virtual chamada VMConfig01 para o modelo de máquina virtual armazenado em $VMTemplate para implantação no grupo de hosts armazenado em $HostGroup, especificando um valor de centro de custo de 1234.
Parâmetros
-AvailabilitySetNames
Especifica uma lista de nomes de conjunto de disponibilidade.
Tipo: | System.Collections.Generic.List`1[System.String] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CapabilityProfile
Especifica um objeto de perfil de funcionalidade.
Tipo: | CapabilityProfile |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Cloud
Especifica um objeto de nuvem privada.
Tipo: | Cloud |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
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 formatos válidos são:
- FQDN
- Endereço IPv4
- Endereço 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 |
-ComputerTier
Especifica um objeto de camada de computador.
Tipo: | ComputerTier |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CostCenter
Especifica o centro de custo de uma máquina virtual para que você possa coletar dados sobre a alocação de máquinas virtuais (ou recursos alocados para máquinas virtuais) para fazer uso em seu sistema de cobrança.
Tipo: | String |
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 a configuração da máquina virtual.
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 |
-Name
Especifica o nome de um objeto VMM (Virtual Machine Manager).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-OnBehalfOfUser
Especifica o nome de um usuário. Esse cmdlet define o nome do usuário como o usuário especificado 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 |
-OnBehalfOfUserRole
Especifica uma função de usuário. Esse cmdlet define a função em nome do usuário como a função de usuário especificada por esse parâmetro. Para obter um objeto de função de usuário, use o cmdlet Get-SCUserRole.
Tipo: | UserRole |
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 |
-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 |
-VMHostGroup
Especifica um objeto de grupo de host de máquina virtual ou uma matriz de objetos de grupo de host.
Tipo: | HostGroup |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-VMTemplate
Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.
Tipo: | Template |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Saídas
VMConfiguration
Esse cmdlet retorna um objeto VMConfiguration
Observações
- Requer um objeto de modelo de máquina virtual do VMM, que você pode obter usando o cmdlet Get-SCVMTemplate
.