Partilhar via

New-SCVMConfiguration

  • Referência
Módulo:
VirtualMachineManager

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 da 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 o 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 hosts chamado Production 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 no $VMTemplate para implantação no grupo de hosts armazenado no $HostGroup, especificando um valor de centro de custo de 1234.

Parâmetros

-AvailabilitySetNames

Especifica uma lista de nomes de conjuntos de disponibilidade.

Tipo:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CapabilityProfile

Especifica um objeto de perfil de capacidade.

Tipo:CapabilityProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Cloud

Especifica um objeto de nuvem privada.

Tipo:Cloud
Position:Named
Default value:None
Necessário:True
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 formatos válidos são:

  • FQDN
  • Endereço IPv4
  • Endereço IPv6
  • Nome NetBIOS
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ComputerTier

Especifica um objeto de camada de computador.

Tipo:ComputerTier
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 usar em seu sistema de cobrança.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

Especifica uma descrição para a configuração da máquina virtual.

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

-Name

Especifica o nome de um objeto do Virtual Machine Manager (VMM).

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

Especifica o nome de um usuário. Este cmdlet define o em nome do usuário como o usuário especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Este 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
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

-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

-VMHostGroup

Especifica um objeto de grupo de host de máquina virtual ou uma matriz de objetos de grupo de hosts.

Tipo:HostGroup
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

Tipo:Template
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

VMConfiguration

Este cmdlet retorna um VMConfiguration objeto.

Notas

  • Requer um objeto de modelo de máquina virtual do VMM, que você pode obter usando o cmdlet Get-SCVMTemplate.