New-SCPhysicalComputerConfig

  • Referência
Módulo:
VirtualMachineManager

Cria um objeto de configuração de computador.

Syntax

New-SCPhysicalComputerConfig
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-BMCAddress <String>]
   [-BMCRunAsAccount <RunAsAccount>]
   [-BMCPort <Int32>]
   [-BMCProtocol <OutOfBandManagementType>]
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   [-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>]
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   [-ComputerName <String>]
   [-BootDiskVolume <String>]
   -Computer <ClientObject>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCPhysicalComputerConfig
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-SMBiosGuid <Guid>]
   [-SkipBmcPowerControl]
   -PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   [-VMHostGroup <HostGroup>]
   [-BypassADMachineAccountCheck]
   [-BootDiskVolume <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCPhysicalComputerConfig
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-SMBiosGuid <Guid>]
   -BMCAddress <String>
   -BMCRunAsAccount <RunAsAccount>
   [-BMCPort <Int32>]
   -BMCProtocol <OutOfBandManagementType>
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   -PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   [-VMHostGroup <HostGroup>]
   [-BypassADMachineAccountCheck]
   [-BootDiskVolume <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet New-SCPhysicalComputerConfig cria um objeto de configuração de computador usado durante o processo de personalização do sistema operacional.

Exemplos

Exemplo 1: Criar uma configuração de computador físico

PS C:\> $Account = Get-SCRunaAsAccount -Name "BMCAdmin" 
PS C:\> $PhysicalComputerProfile = Get-SCPhysicalComputerProfile -ID "d1ce0773-4f50-4f12-a244-38a5a35c5326" 
PS C:\> $NetworkAdapters = New-SCPhysicalComputerNetworkAdapterConfig -UseDhcpForIPConfiguration -SetAsManagementNIC -SetAsPhysicalNetworkAdapter 
PS C:\> $HostGroup = Get-SCVMHostGroup -ID "0e3ba228-a059-46be-aa41-2f5cf0f4b96e" 
PS C:\> New-SCPhysicalComputerConfig -BMCAddress 10.0.0.21 -BMCPort 623 -BMCProtocol IPMI -BMCRunAsAccount $Account -ComputerName "Host01" -SMBiosGuid "4c4c4544-0039-4410-8042-c3c04f395031" -PhysicalComputerProfile $PhysicalComputerProfile -VMHostGroup $HostGroup -PhysicalComputerNetworkAdapterConfig $NetworkAdapters

O primeiro comando obtém um objeto de conta Executar como e o armazena na variável $Account.

O segundo comando armazena o perfil de computador físico que tem a ID d1ce0773-4f50-4f12-a244-38a5a35c5326 na variável $PhysicalComputerProfile.

O terceiro comando cria uma configuração de adaptador de rede de computador físico e armazena na variável $NetworkAdapters.

O quarto cmdlet armazena o grupo de hosts na variável $HostGroup.

O comando final cria uma configuração de computador físico. O comando especifica os valores criados em comandos anteriores.

Parâmetros

-BMCAddress

Especifica ou atualiza o endereço BMC (controlador de gerenciamento de base) fora da banda para um computador físico específico. Pode ser um endereço IP, o FQDN (nome de domínio totalmente qualificado) ou o prefixo DNS (que geralmente é o mesmo nome que o nome NetBIOS).

Normalmente, o endereço BMC e sua conexão com a rede são separados do endereço IP associado a um adaptador de rede padrão. Como alternativa, alguns computadores usam um adaptador de rede padrão para fornecer um único endereço para o BMC e para o adaptador de rede. No entanto, o endereço BMC tem uma porta exclusiva e, portanto, é exclusivamente identificável na rede.

  • Exemplo de formato IPv4: -BMCAddress "10.0.0.21"
  • Exemplo de formato Ipv6: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • Exemplo de formato FQDN: -BMCAddress "Computer01.Contoso.com"
  • Exemplo de formato NetBIOS: -BMCAddress "Computer01"

Observação: por padrão, o VMM usa um endereço IP ou FQDN para o endereço BMC. No entanto, também é possível criar um módulo do PowerShell que permite que você especifique outros tipos de endereços como o endereço BMC.

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

-BMCCustomConfigurationProvider

Especifica ou atualiza um objeto de provedor de configuração para um BMC (controlador de gerenciamento de quadro de base). Um provedor de configuração é um plug-in para o VMM que converte comandos do PowerShell do VMM para chamadas à API específicas para um tipo de controlador de gerenciamento de quadro de base. Esse parâmetro deve ser usado com o BMCProtocol personalizado.

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

-BMCPort

Especifica ou atualiza a porta BMC (controlador de gerenciamento de placa base) fora da banda para um computador físico específico. Uma porta BMC também é conhecida como uma porta do processador de serviço. As portas padrão de exemplo são 623 para IPMI e 443 para SMASH sobre WS-Man.

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

-BMCProtocol

Especifica ou atualiza o protocolo que o VMM usa para se comunicar com o BMC (controlador de gerenciamento de placa base fora de banda). Os valores válidos são:

  • IPMI
  • ESMAGAR
  • Personalizado

Um BMC (também conhecido como processador de serviço ou controlador de gerenciamento) é um controlador especializado na placa-mãe de um servidor que atua em uma interface entre o hardware e o software de gerenciamento do sistema. Se a placa-mãe de um computador físico incluir um BMC, quando o computador estiver conectado (se ele estiver desligado ou ligado e se um sistema operacional está instalado ou não), informações sobre o hardware do sistema e o estado dessa integridade de hardware do sistema estarão disponíveis.

Formato de exemplo: -BMCProtocol "Custom"

Observação: o protocolo Personalizado exige que você use o parâmetro BMCCustomConfigurationProvider .

Type:OutOfBandManagementType
Accepted values:None, IPMI, SMASH, Custom, None, IPMI, SMASH, Custom
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BMCRunAsAccount

Especifica a conta Executar como a ser usada com o dispositivo BMC (controlador de gerenciamento de quadro de base).

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

-BootDiskVolume

Especifica um objeto de disco rígido físico para um computador físico.

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

-BypassADMachineAccountCheck

Indica que esse cmdlet reutilizará uma conta de computador que já existe no Active Directory. Por padrão, esse cmdlet verifica o Active Directory para obter uma conta existente com o nome especificado para impedir a substituição de contas de computador.

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

-Computer

Especifica ou atualiza o endereço BMC (controlador de gerenciamento de base) fora da banda para um computador físico específico. Pode ser um endereço IP, o FQDN (nome de domínio totalmente qualificado) ou o prefixo DNS (que geralmente é o mesmo nome que o nome NetBIOS).

  • Exemplo de formato IPv4: -BMCAddress "10.0.0.21"
  • Exemplo de formato Ipv6: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • Exemplo de formato FQDN: -BMCAddress "Computer01.Contoso.com"
  • Exemplo de formato NetBIOS: -BMCAddress "Computer01"

Observação: por padrão, o VMM usa um endereço IP ou FQDN para o endereço BMC. No entanto, também é possível criar um módulo do PowerShell que permite que você especifique outros tipos de endereços como o endereço BMC.

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

-Description

Especifica uma descrição para o objeto de configuração.

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

-PhysicalComputerNetworkAdapterConfig

Especifica uma matriz de objetos PhysicalComputerNetworkAdapterConfig .

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

-PhysicalComputerProfile

Especifica um perfil usado para implantar um sistema operacional em um computador.

Type:PhysicalComputerProfile
Position:Named
Default value:None
Required:True
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

-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

-SkipBmcPowerControl

Ignora informações do BMC e implanta um sistema operacional sem ligar ou desativar o computador usando sua interface BMC.

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

-SMBiosGuid

Especifica o IDENTIFICADOR global exclusivo do BIOS (SMBIOS GUID) do System Management para um computador físico associado a um registro para esse computador físico no VMM. O SMBIOS define estruturas de dados e métodos de acesso que permitem que um usuário ou aplicativo armazene e recupere informações sobre hardware neste computador, como o nome do sistema, do fabricante ou da versão bios do sistema. Os sistemas operacionais Windows recuperam dados SMBIOS na inicialização do sistema e disponibilizam esses dados para programas.

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

-VMHostGroup

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

Type:HostGroup
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

Saídas

PhysicalComputerConfig

Este cmdlet retorna um objeto PhysicalComputerConfig .