Freigeben über

New-SCPhysicalComputerConfig

  • Referenz
Modul:
VirtualMachineManager

Erstellt ein Computerkonfigurationsobjekt.

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

Beschreibung

Das Cmdlet New-SCPhysicalComputerConfig erstellt ein Computerkonfigurationsobjekt, das während des Anpassungsprozesses des Betriebssystems verwendet wird.

Beispiele

Beispiel 1: Erstellen einer physischen Computerkonfiguration

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

Der erste Befehl ruft ein Run As-Kontoobjekt ab und speichert es in der $Account Variablen.

Der zweite Befehl speichert das physische Computerprofil mit der ID d1ce0773-4f50-4f12-a244-38a5a35c5326 in der variablen $PhysicalComputerProfile.

Mit dem dritten Befehl wird eine Konfiguration des physischen Computernetzwerkadapters erstellt und in der variablen $NetworkAdapters gespeichert.

Das vierte Cmdlet speichert die Hostgruppe in der variablen $HostGroup.

Der letzte Befehl erstellt eine physische Computerkonfiguration. Der Befehl gibt die werte an, die in vorherigen Befehlen erstellt wurden.

Parameter

-BMCAddress

Gibt die Out-of-Band-Baseboard-Verwaltungscontrolleradresse (BMC) für einen bestimmten physischen Computer an oder aktualisiert sie. Dies kann eine IP-Adresse, der vollqualifizierte Domänenname (FQDN) oder das DNS-Präfix (normalerweise derselbe Name wie der NetBIOS-Name) sein.

In der Regel sind die BMC-Adresse und ihre Verbindung mit dem Netzwerk von der IP-Adresse getrennt, die einem Standardnetzwerkadapter zugeordnet ist. Alternativ verwenden einige Computer einen Standardnetzwerkadapter, um eine einzelne Adresse für den BMC und den Netzwerkadapter bereitzustellen. Die BMC-Adresse hat jedoch einen eindeutigen Port und ist somit eindeutig im Netzwerk identifizierbar.

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

Hinweis: Standardmäßig verwendet VMM eine IP-Adresse oder einen FQDN für die BMC-Adresse. Es ist jedoch auch möglich, ein PowerShell-Modul zu erstellen, mit dem Sie andere Adresstypen als BMC-Adresse angeben können.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BMCCustomConfigurationProvider

Gibt ein Konfigurationsanbieterobjekt für einen Baseboard-Verwaltungscontroller (Baseboard Management Controller, BMC) an oder aktualisiert. Ein Konfigurationsanbieter ist ein Plug-In zu VMM, das VMM PowerShell-Befehle in API-Aufrufe übersetzt, die spezifisch für einen Typ des Baseboardverwaltungscontrollers sind. Dieser Parameter sollte mit dem Custom BMCProtocol verwendet werden.

Typ:ConfigurationProvider
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BMCPort

Gibt den Out-of-Band-Baseboard-Verwaltungscontroller (BMC)-Port für einen bestimmten physischen Computer an. Ein BMC-Port wird auch als Dienstprozessorport bezeichnet. Beispiel für Standardports sind 623 für IPMI und 443 für SMASH über WS-Man.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BMCProtocol

Gibt das Protokoll an, das VMM für die Kommunikation mit dem Out-of-Band-Baseboard-Verwaltungscontroller (Out-of-Band Baseboard Management Controller, BMC) verwendet. Gültige Werte sind:

  • IPMI
  • ZERSCHMETTERN
  • Gewohnheit

Ein BMC (auch als Dienstprozessor oder Verwaltungscontroller bezeichnet) ist ein spezieller Controller auf der Hauptplatine eines Servers, der eine Schnittstelle zwischen der Hardware- und Systemverwaltungssoftware fungiert. Wenn die Hauptplatine eines physischen Computers einen BMC enthält, wenn der Computer angeschlossen ist (unabhängig davon, ob es ausgeschaltet oder eingeschaltet ist und ob ein Betriebssystem installiert ist), sind Informationen zur Systemhardware und zum Zustand dieser Systemhardware verfügbar.

Beispielformat: -BMCProtocol "Custom"

Hinweis: Das benutzerdefinierte Protokoll erfordert, dass Sie den BMCCustomConfigurationProvider Parameter verwenden.

Typ:OutOfBandManagementType
Zulässige Werte:None, IPMI, SMASH, Custom, None, IPMI, SMASH, Custom
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BMCRunAsAccount

Gibt das Run As-Konto an, das mit dem Baseboard-Verwaltungscontroller (Baseboard Management Controller, BMC) verwendet werden soll.

Typ:RunAsAccount
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BootDiskVolume

Gibt ein physisches Festplattenobjekt für einen physischen Computer an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BypassADMachineAccountCheck

Gibt an, dass dieses Cmdlet ein Computerkonto wiederverwendet, das bereits in Active Directory vorhanden ist. Standardmäßig überprüft dieses Cmdlet Active Directory auf ein vorhandenes Konto mit dem angegebenen Namen, um das Überschreiben von Computerkonten zu verhindern.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Computer

Gibt die Out-of-Band-Baseboard-Verwaltungscontrolleradresse (BMC) für einen bestimmten physischen Computer an oder aktualisiert sie. Dies kann eine IP-Adresse, der vollqualifizierte Domänenname (FQDN) oder das DNS-Präfix (normalerweise derselbe Name wie der NetBIOS-Name) sein.

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

Hinweis: Standardmäßig verwendet VMM eine IP-Adresse oder einen FQDN für die BMC-Adresse. Es ist jedoch auch möglich, ein PowerShell-Modul zu erstellen, mit dem Sie andere Adresstypen als BMC-Adresse angeben können.

Typ:ClientObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt den Namen eines Computers an, den VMM in Ihrem Netzwerk eindeutig identifizieren kann. Die zulässigen Werte für diesen Parameter sind:

  • FQDN
  • IPv4- oder IPv6-Adresse
  • NetBIOS-Name
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für das Konfigurationsobjekt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PhysicalComputerNetworkAdapterConfig

Gibt ein Array von PhysicalComputerNetworkAdapterConfig- -Objekten an.

Typ:PhysicalComputerNetworkAdapterConfig[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PhysicalComputerProfile

Gibt ein Profil an, das zum Bereitstellen eines Betriebssystems auf einem Computer verwendet wird.

Typ:PhysicalComputerProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipBmcPowerControl

Überspringt BMC-Informationen und stellt ein Betriebssystem bereit, ohne den Computer über die BMC-Schnittstelle ein- oder auszuschalten.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SMBiosGuid

Gibt den systemverwaltungs-BIOS global eindeutigen Bezeichner (SMBIOS GUID) für einen physischen Computer an, der einem Datensatz für diesen physischen Computer in VMM zugeordnet ist. SMBIOS definiert Datenstrukturen und Zugriffsmethoden, die es einem Benutzer oder einer Anwendung ermöglichen, Informationen über Hardware auf diesem Computer zu speichern und abzurufen, z. B. den Namen des Systems, herstellers oder die System-BIOS-Version. Windows-Betriebssysteme rufen SMBIOS-Daten beim Systemstart ab und stellen diese Daten programmen zur Verfügung.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMHostGroup

Gibt ein Hostgruppenobjekt eines virtuellen Computers oder ein Array von Hostgruppenobjekten an.

Typ:HostGroup
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

PhysicalComputerConfig

Dieses Cmdlet gibt ein PhysicalComputerConfig-Objekt zurück.