Freigeben über


New-SCPhysicalComputerProfile

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

Syntax

New-SCPhysicalComputerProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-UseAsVMHost]
   -PhysicalComputerNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCPhysicalComputerProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   [-JoinWorkgroup]
   -LocalAdministratorCredential <VMMCredential>
   [-UseAsVMHost]
   -PhysicalComputerNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-IsGuarded <Boolean>]
   [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-Baseline <Baseline[]>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCPhysicalComputerProfile
   [-Name] <String>
   -VirtualHardDisk <VirtualHardDisk>
   -Domain <String>
   -DomainJoinRunAsAccount <RunAsAccount>
   -LocalAdministratorCredential <VMMCredential>
   [-UseAsFileServer]
   -PhysicalComputerNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>
   [-ComputerAccessRunAsAccount <RunAsAccount>]
   [-DiskConfiguration <String>]
   [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>]
   [-VMPaths <String>]
   [-FullName <String>]
   [-GuiRunOnceCommands <String[]>]
   [-OrganizationName <String>]
   [-ProductKey <String>]
   [-TimeZone <Int32>]
   [-JobGroup <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCPhysicalComputerProfile
   [-Name] <String>
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-Description <String>]
   [-Owner <String>]
   [-AnswerFile <Script>]
   [-BypassVHDConversion <Boolean>]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCPhysicalComputerProfile erstellt ein Profil, das zum Bereitstellen eines Betriebssystems auf einem Computer verwendet wird.

Beispiele

Beispiel 1: Erstellen eines physischen Computerprofils

PS C:\> $Account = Get-SCRunaAsAccount -Name "CloudAdmin" 
PS C:\> $Credential = Get-Credential "Contoso\ServiceAdmin" 
PS C:\> $AdapterProfile = Get-SCPhysicalComputerNetworkAdapterProfile -ID "eede207d-d263-4212-ad32-fd29b5a1a6ce" 
PS C:\> $Vhd = Get-SCVirtualHardDisk -Name "Win2012stdGen1template_disk_1.vhdx" 
PS C:\> New-SCPhysicalComputerProfile -Name "ContosoHostProfile" -Domain "contoso.com" -DomainJoinRunAsAccount $Account -LocalAdministratorCredential $Credential -PhysicalComputerNetworkAdapterProfile $AdapterProfile -UseAsVMHost -VirtualHardDisk $Vhd

Der erste Befehl ruft das Run As-Kontoobjekt ab und speichert es in einer Variablen namens $Account.

Der zweite Befehl erstellt ein Windows PowerShell Anmeldeinformationenobjekt für das Konto Contoso\ServiceAdmin und speichert es in der $Credential Variablen. Sie müssen das Kennwort für das ServiceAdmin-Konto an das Cmdlet Get-Credential angeben.

Der dritte Befehl erstellt einen Objektverweis auf das Profil des physischen Computernetzwerkadapters mit der angegebenen ID und speichert ihn in der variablen $AdapterProfile.

Der vierte Befehl erstellt einen Objektverweis mithilfe des Cmdlets Get-SCVirtualHardDisk . Diese Objektverweise sind der virtuellen Festplatte Win2012stdGen1template_disk_1.vhdx zugeordnet.

Der letzte Befehl erstellt ein physisches Computerprofil namens ContosoHostProfile basierend auf den Werten aus vorherigen Befehlen.

Parameter

-AnswerFile

Gibt ein Skriptobjekt an, das in der VMM-Bibliothek (Virtual Machine Manager) gespeichert ist, die als Antwortdatei verwendet werden soll. Der Name des Antwortdateiskripts hängt von dem Betriebssystem ab, auf dem Sie die virtuelle Maschine installieren möchten:

  • Sysprep.inf. Windows XP, Windows Server 2000 oder Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 oder Windows Server 2008
Type:Script
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Baseline

Gibt ein Array von Baseline-Objekten an.

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

-BypassVHDConversion

Gibt an, ob eine dynamische VHD, die an ein Hostprofil angefügt ist, während der Bereitstellung in einen festen Typ konvertiert wird.

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

-CodeIntegrityPolicy

Gibt eine Codeintegritätsrichtlinie an.

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

-ComputerAccessRunAsAccount

Gibt den Computerzugriff "Run As" an, der zum Bereitstellen des Computers verwendet werden soll. Dieses Run As-Konto wird dem Computer als lokaler Administrator hinzugefügt und zum Verwalten des Computers verwendet.

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

-Description

Gibt eine Beschreibung für das Computerprofil an.

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

-DiskConfiguration

Gibt die Datenträger- und Partitionskonfiguration für den physischen Computer an, der mit Windows Hyper-V bereitgestellt werden soll.

Beispielformat: -DiskConfiguration "MBR=1:PRIMARY:QUICK:4:FALSE:OS::0:BOOTPARTITION;"

Sie müssen unbedingt die richtige Clustergröße angeben. Im obigen Beispiel ist die Clustergröße 0. Wenn Sie keine Clustergröße angeben, verwendet VMM die Standardeinstellung von 512 Bytes, die möglicherweise nicht geeignet sind, erweiterte Formatdatenträger zu konfigurieren.

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

-Domain

Gibt einen vollqualifizierten Domänennamen (FQDN) für eine Active Directory-Domäne an.

Beispielformat: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinRunAsAccount

Gibt ein Run As-Konto an, das über die Berechtigung zum Beitreten zur angegebenen Domäne verfügt.

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

-DriverMatchingTag

Gibt die benutzerdefinierten Tags an, die während der Bereitstellung mit Treibereigenschaften übereinstimmen sollen. Wenn Tags angegeben werden, entspricht der Bereitstellungsprozess den im Hostprofil angegebenen Tags mit den Tags in den Treibern, um übereinstimmende Treiber herunterzuladen und sie im Zielimage zu installieren.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullName

Gibt den Namen der Person an, in deren Namen eine virtuelle Maschine registriert ist.

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

-GuiRunOnceCommands

Gibt ein Array von Befehlen an, die dem Abschnitt [GuiRunOnce] einer unbeaufsichtigten Antwortdatei hinzugefügt werden sollen. Verwenden Sie einzelne Anführungszeichen um jede Zeichenfolge, die in doppelte Anführungszeichen eingeschlossen ist.

Beispielformat: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Informationen dazu, wie Windows PowerShell Anführungszeichen verwendet, geben Sie einGet-Help about_Quoting_Rules.

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

-IsGuarded

Gibt an, dass der Host ein geschützter Host sein muss.

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

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

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

-JoinWorkgroup

Gibt an, dass dieser Vorgang einer Arbeitsgruppe beigetreten ist.

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

-LocalAdministratorCredential

Gibt den Benutzernamen und das Kennwort für das lokale Administratorkonto (oder das Linux-Stammkonto im Falle eines Linux-kompatiblen Gastbetriebssystemprofils) an.

Wenn Sie Anmeldeinformationen für eine neue oder vorhandene Vorlage angeben, auf einem neuen oder vorhandenen Gastbetriebssystemprofil oder auf einem neuen virtuellen Computer überschreibt jedes vorhandene Administratorkennwort.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-OrganizationName

Gibt den Namen der Organisation für die Person an, in der ein virtueller Computer registriert ist.

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

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalComputerNetworkAdapterProfile

Gibt ein Array physischer Netzwerkadapterprofilobjekte an.

Type:PhysicalComputerNetworkAdapterProfile[]
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:True
Accept wildcard characters:False

-ProductKey

Gibt einen Product Key an. Beim Product Key handelt es sich um eine 25-stellige Zahl zur Identifizierung der Produktlizenz. Ein Product Key kann verwendet werden, um VMM oder ein Betriebssystem zu registrieren, das auf einem virtuellen Computer oder Host installiert werden soll.

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

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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-TimeZone

Gibt eine Zahl (einen Index) an, die eine geografische Region identifiziert, die dieselbe Standardzeit hat. Eine Liste der Zeitzonenindizes finden Sie unter Microsoft Time Zone Index Values at http://go.microsoft.com/fwlink/?LinkId=120935. Wenn keine Zeitzone angegeben ist, wird als Standardzeitzone für eine virtuelle Maschine die gleiche Zeitzoneneinstellung wie auf dem Host für virtuelle Maschinen verwendet.

Beispielformat zum Angeben der GMT-Standardzeitzone: -TimeZone 085

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

-UseAsFileServer

Markiert das Profil als Dateiserverprofil.

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

-UseAsVMHost

Markiert das Profil als Hostprofil eines virtuellen Computers.

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

-VirtualHardDisk

Gibt ein virtuelles Festplattenobjekt an.

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

-VMPaths

Gibt einen Satz Standardpfade (als durch den Pipelineoperator getrennte Zeichenfolgen) auf einem Host an, auf dem Dateien für virtuelle Maschinen gespeichert werden können.

Beispielformat: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Ausgaben

PhysicalComputerProfile

Dieses Cmdlet gibt ein PhysicalComputerProfile -Objekt zurück.