Partilhar via

New-SCVMConfiguration

Módulo:
VirtualMachineManager Module

Cria uma configuração de máquina virtual a partir de um modelo de máquina virtual.

Sintaxe

FromTemplateOnly (Predefinição) 

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

Cloud 

New-SCVMConfiguration
    -VMTemplate <Template>
    -Name <String>
    -Cloud <Cloud>
    [-Description <String>]
    [-CostCenter <String>]
    [-CapabilityProfile <CapabilityProfile>]
    [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VMHostGroup 

New-SCVMConfiguration
    -VMTemplate <Template>
    -Name <String>
    -VMHostGroup <HostGroup>
    [-Description <String>]
    [-CostCenter <String>]
    [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ComputerTier 

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.

Propriedades dos parâmetros

Tipo:

System.Collections.Generic.List`1[System.String]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CapabilityProfile

Especifica um objeto de perfil de capacidade.

Propriedades dos parâmetros

Tipo:CapabilityProfile
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Cloud
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Cloud

Especifica um objeto de nuvem privada.

Propriedades dos parâmetros

Tipo:Cloud
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Cloud
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerTier
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ComputerTier

Especifica um objeto de camada de computador.

Propriedades dos parâmetros

Tipo:ComputerTier
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerTier
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Description

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromTemplateOnly
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ComputerTier
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:UserRole
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsynchronously

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMHostGroup

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

Propriedades dos parâmetros

Tipo:HostGroup
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHostGroup
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMTemplate

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

Propriedades dos parâmetros

Tipo:Template
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromTemplateOnly
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
Cloud
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
VMHostGroup
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

VMConfiguration

Este cmdlet retorna um objeto VMConfiguration .

Notas

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