Freigeben über


Set-SCPhysicalComputerProfile

Ändert ein physisches Computerprofilobjekt.

Syntax

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

Beschreibung

Das Cmdlet Set-SCPhysicalComputerProfile ändert ein physisches Computerprofilobjekt.

Beispiele

Beispiel 1: Ändern eines physischen Computerprofils

PS C:\> $PhysicalComputerProfile = Get-SCPhysicalComputerProfile -ID "d1ce0773-4f50-4f12-a244-38a5a35c5326" 
PS C:\> Set-SCPhysicalComputerProfile -PhysicalComputerProfile $PhysicalComputerProfile -RunAsynchronously -Name "Windows Server 2016"

Der erste Befehl speichert das physische Computerprofil, das über die angegebene ID in der $PhysicalComputerProfile Variablen verfügt.

Der zweite Befehl ändert den Namen des physischen Computerprofils, das Windows Server 2016 werden soll.

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, in einen festen Typ konvertiert wird, während der Bereitstellung.

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 als Konto an, mit dem der Computer bereitgestellt werden soll. Diese Ausführung 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.

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:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainJoinRunAsAccount

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

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

-DriverMatchingTag

Gibt die benutzerdefinierten Tags an, die während der Bereitstellung mit Treibereigenschaften übereinstimmen. 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 den Typ Get-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 guarded 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

-LocalAdministratorCredential

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

Wenn Sie Anmeldeinformationen für eine neue oder vorhandene Vorlage angeben, in einem neuen oder vorhandenen Gastbetriebssystemprofil oder auf einem neuen virtuellen Computer werden alle vorhandenen Administratorkennworte außer Kraft gesetzt.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-OrganizationName

Gibt den Namen der Organisation für die Person an, deren Name 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 von physischen Netzwerkadapterprofilobjekten an.

Type:PhysicalComputerNetworkAdapterProfile[]
Position:Named
Default value:None
Required:False
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 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

-RemoveAnswerFile

Entfernt die Antwortdatei aus dem Hostprofil.

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

-RemoveGuiRunOnceCommands

Entfernt die GUI Run Once Commands-Eigenschaft aus dem Hostprofil.

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

-TimeZone

Gibt eine Zahl (ein Index) an, die eine geografische Region identifiziert, die dieselbe Standardzeit teilt. 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

-VirtualHardDisk

Gibt ein virtuelles Festplattenobjekt an.

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

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