Freigeben über


New-SCPhysicalComputerConfig

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 Variable.

Der zweite Befehl speichert das physische Computerprofil, das über die ID d1ce0773-4f50-4f12-a244-38a5a35c5326 in der $PhysicalComputerProfile Variable verfügt.

Der dritte Befehl erstellt eine Konfiguration des physischen Computernetzwerkadapters und speichert sie in der $NetworkAdapters Variablen.

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

Der endgültige Befehl erstellt eine physische Computerkonfiguration. Der Befehl gibt die werte an, die in früheren 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 sein (der in der Regel der gleiche Name wie der NetBIOS-Name ist).

In der Regel sind die BMC-Adresse und die Verbindung mit dem Netzwerk getrennt von der IP-Adresse, 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 auf dem Netzwerk identifizierbar.

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

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

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

-BMCCustomConfigurationProvider

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

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

-BMCPort

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

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

-BMCProtocol

Gibt das Protokoll an, das VMM verwendet, um mit dem Out-of-Band-Baseboard-Verwaltungscontroller (BMC) zu kommunizieren. Gültige Werte sind:

  • IPMI
  • SMASH
  • Benutzerdefiniert

Ein BMC (auch als Dienstprozessor oder Verwaltungscontroller bezeichnet) ist ein spezialisierter Controller auf dem Motherboard eines Servers, der eine Schnittstelle zwischen der Hardware- und Systemverwaltungssoftware darstellt. Wenn das Motherboard eines physischen Computers einen BMC enthält, wenn der Computer angeschlossen ist (ob es ausgeschaltet oder aktiviert ist, und ob ein Betriebssystem installiert ist), informationen zu Systemhardware und dem Zustand dieser Systemhardware verfügbar.

Beispielformat: -BMCProtocol "Custom"

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

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

Gibt das Ausführen als Konto an, das mit dem BMC-Gerät (Baseboard Management Controller) verwendet werden soll.

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

-BootDiskVolume

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 für ein vorhandenes Konto mit dem angegebenen Namen, um das Überschreiben von Computerkonten zu verhindern.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 sein (der in der Regel der gleiche Name wie der NetBIOS-Name ist).

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

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

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

-ComputerName

Gibt den Namen eines Computers an, der von VMM eindeutig im Netzwerk identifiziert werden kann. Zulässige Werte für diesen Parameter:

  • FQDN
  • IPv4- oder IPv6-Adresse
  • NetBIOS-Name
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Gibt eine Beschreibung für das Konfigurationsobjekt an.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-PhysicalComputerNetworkAdapterConfig

Gibt ein Array von PhysicalComputerNetworkAdapterConfig-Objekten an.

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

-PhysicalComputerProfile

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

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

-PROTipID

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

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-SkipBmcPowerControl

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

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

-SMBiosGuid

Gibt den global eindeutigen Id (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 zu 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 für Programme zur Verfügung.

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

-VMHostGroup

Gibt ein Hostgruppenobjekt für virtuelle Maschinen oder einen Array aus Hostgruppenobjekten an.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

PhysicalComputerConfig

Dieses Cmdlet gibt ein PhysicalComputerConfig-Objekt zurück.