Delen via

New-SCPhysicalComputerConfig

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een computerconfiguratieobject.

Syntaxis

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

De New-SCPhysicalComputerConfig cmdlet maakt een computerconfiguratieobject dat wordt gebruikt tijdens het aanpassingsproces van het besturingssysteem.

Voorbeelden

Voorbeeld 1: Een configuratie van een fysieke computer maken

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

Met de eerste opdracht wordt een Uitvoeren als-accountobject opgehaald en opgeslagen in de $Account variabele.

Met de tweede opdracht wordt het profiel van de fysieke computer opgeslagen met de id d1ce0773-4f50-4f12-a244-38a5a35c5326 in de $PhysicalComputerProfile variabele.

Met de derde opdracht maakt u een configuratie van een fysieke computernetwerkadapter en slaat u deze op in de $NetworkAdapters variabele.

Met de vierde cmdlet wordt de hostgroep opgeslagen in de variabele $HostGroup.

Met de laatste opdracht maakt u een configuratie van een fysieke computer. De opdracht geeft de waarden op die zijn gemaakt in eerdere opdrachten.

Parameters

-BMCAddress

Hiermee geeft u het out-of-band BMC-adres (Baseboard Management Controller) op voor een specifieke fysieke machine. Dit kan een IP-adres, de FQDN (Fully Qualified Domain Name) of het DNS-voorvoegsel zijn (meestal dezelfde naam als de NetBIOS-naam).

Normaal gesproken zijn het BMC-adres en de verbinding met het netwerk gescheiden van het IP-adres dat is gekoppeld aan een standaardnetwerkadapter. Sommige computers gebruiken ook een standaardnetwerkadapter om één adres voor de BMC en voor de netwerkadapter op te geven. Het BMC-adres heeft echter een unieke poort en is dus uniek identificeerbaar op het netwerk.

  • Voorbeeld van IPv4-indeling: -BMCAddress "10.0.0.21"
  • Voorbeeld van ipv6-indeling: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • Voorbeeld van FQDN-indeling: -BMCAddress "Computer01.Contoso.com"
  • Voorbeeld van NetBIOS-indeling: -BMCAddress "Computer01"

Opmerking: VMM maakt standaard gebruik van een IP-adres of FQDN voor het BMC-adres. Het is echter ook mogelijk om een PowerShell-module te maken waarmee u andere typen adressen kunt opgeven als het BMC-adres.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BMCCustomConfigurationProvider

Hiermee geeft u een configuratieproviderobject op voor een BMC (Baseboard Management Controller). Een configuratieprovider is een invoegtoepassing voor VMM die VMM PowerShell-opdrachten vertaalt naar API-aanroepen die specifiek zijn voor een type baseboard-beheercontroller. Deze parameter moet worden gebruikt met het Custom BMCProtocol.

Type:ConfigurationProvider
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BMCPort

Hiermee geeft u de out-of-band BMC-poort (Baseboard Management Controller) op voor een specifieke fysieke machine. Een BMC-poort wordt ook wel een serviceprocessorpoort genoemd. Voorbeeld van standaardpoorten zijn 623 voor IPMI en 443 voor SMASH via WS-Man.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BMCProtocol

Hiermee geeft u het protocol op dat door VMM wordt gebruikt om te communiceren met de out-of-band baseboard management controller (BMC). Geldige waarden zijn:

  • IPMI
  • VERPLETTEREN
  • Gewoonte

Een BMC (ook wel een serviceprocessor of beheercontroller genoemd) is een gespecialiseerde controller op het moederbord van een server die een interface tussen de hardware- en systeembeheersoftware uitvoert. Als het moederbord van een fysieke machine een BMC bevat, wanneer de machine is aangesloten (of deze is uitgeschakeld of ingeschakeld en of een besturingssysteem is geïnstalleerd), informatie over systeemhardware en de status van die systeemhardware beschikbaar is.

Voorbeeldindeling: -BMCProtocol "Custom"

Opmerking: Voor het aangepaste protocol moet u de parameter BMCCustomConfigurationProvider gebruiken.

Type:OutOfBandManagementType
Geaccepteerde waarden:None, IPMI, SMASH, Custom, None, IPMI, SMASH, Custom
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BMCRunAsAccount

Hiermee geeft u het Uitvoeren als-account dat moet worden gebruikt met het BMC-apparaat (Baseboard Management Controller).

Type:RunAsAccount
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BootDiskVolume

Hiermee geeft u een fysiek hardeschijfobject voor een fysieke machine.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BypassADMachineAccountCheck

Hiermee wordt aangegeven dat deze cmdlet een computeraccount opnieuw gebruikt dat al bestaat in Active Directory. Deze cmdlet controleert standaard Active Directory op een bestaand account met de opgegeven naam om te voorkomen dat computeraccounts worden overschreven.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Computer

Hiermee geeft u het out-of-band BMC-adres (Baseboard Management Controller) op voor een specifieke fysieke machine. Dit kan een IP-adres, de FQDN (Fully Qualified Domain Name) of het DNS-voorvoegsel zijn (meestal dezelfde naam als de NetBIOS-naam).

  • Voorbeeld van IPv4-indeling: -BMCAddress "10.0.0.21"
  • Voorbeeld van ipv6-indeling: -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
  • Voorbeeld van FQDN-indeling: -BMCAddress "Computer01.Contoso.com"
  • Voorbeeld van NetBIOS-indeling: -BMCAddress "Computer01"

Opmerking: VMM maakt standaard gebruik van een IP-adres of FQDN voor het BMC-adres. Het is echter ook mogelijk om een PowerShell-module te maken waarmee u andere typen adressen kunt opgeven als het BMC-adres.

Type:ClientObject
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u de naam op van een computer die VMM uniek kan identificeren in uw netwerk. De acceptabele waarden voor deze parameter zijn:

  • FQDN
  • IPv4- of IPv6-adres
  • NetBIOS-naam
Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor het configuratieobject.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PhysicalComputerNetworkAdapterConfig

Hiermee geeft u een matrix van PhysicalComputerNetworkAdapterConfig objecten.

Type:PhysicalComputerNetworkAdapterConfig[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PhysicalComputerProfile

Hiermee geeft u een profiel op dat wordt gebruikt voor het implementeren van een besturingssysteem op een computer.

Type:PhysicalComputerProfile
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipBmcPowerControl

Slaat BMC-informatie over en implementeert een besturingssysteem zonder de computer in of uit te schakelen met behulp van de BMC-interface.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SMBiosGuid

Hiermee geeft u de SYSTEM Management BIOS globally unique identifier (SMBIOS GUID) voor een fysieke computer die is gekoppeld aan een record voor die fysieke computer in VMM. SMBIOS definieert gegevensstructuren en toegangsmethoden waarmee een gebruiker of toepassing informatie over hardware op deze computer kan opslaan en ophalen, zoals de naam van het systeem, de fabrikant of de BIOS-versie van het systeem. Windows-besturingssystemen halen SMBIOS-gegevens op bij het opstarten van het systeem en maken die gegevens beschikbaar voor programma's.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMHostGroup

Hiermee geeft u een hostgroepobject van een virtuele machine of een matrix van hostgroepobjecten.

Type:HostGroup
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

PhysicalComputerConfig

Met deze cmdlet wordt een PhysicalComputerConfig--object geretourneerd.