Freigeben über

Set-SCVMHostProfile

  • Referenz
Modul:
VirtualMachineManager

Ändert die Eigenschaften eines Hostprofils.

Syntax

Set-SCVMHostProfile
   -VMHostProfile <PhysicalComputerProfile>
   [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
   [[-Name] <String>]
   [-VirtualHardDisk <VirtualHardDisk>]
   [-Domain <String>]
   [-DomainJoinRunAsAccount <RunAsAccount>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-RemoveAnswerFile]
   [-RemoveGuiRunOnceCommands]
   [-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-SCVMHostProfile ändert die Eigenschaften eines Hostprofils.

Geben Sie Get-Help New-SCVMHostProfile -DetailedInformationen zum Erstellen eines Hostprofils ein.

Beispiele

Beispiel 1: Festlegen des Zeitzonenwerts für ein angegebenes Hostprofil

PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Set-SCVMHostProfile -TimeZone 035

Dieser Befehl ruft das Hostprofilobjekt namens HostProfile01 ab und legt seinen Zeitzonenwert auf die Zeitzone der USA (035) fest.

Beispiel 2: Hinzufügen eines Hostnetzwerkadapterprofils zu einem Hostprofil

PS C:\> $VMHostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> $HostNetAdapterProf = Get-SCVMHostNetworkAdapterProfile -ID "259f47c7-c5a9-429d-a421-d232f9b34991"
PS C:\> Set-SCVMHostProfile -VMHostPRofile $VMHostProfile -VMHostNetworkAdapterProfile $HostNetAdapterProf

Der erste Befehl ruft das Hostprofilobjekt namens HostProfile01 ab und speichert das Objekt in der $VMHostProfile Variable.

Der zweite Befehl ruft das Hostnetzwerkadapterprofilobjekt mit der ID 259f47c7c7-c5a9-429d-a421-d232f9b34991 ab und speichert das Objekt in der $HostNetAdapterProf Variable.

Der letzte Befehl fügt das in $HostNetAdapterProf gespeicherte Hostnetzwerkadapterprofil zu HostProfile01 hinzu.

Parameter

-AnswerFile

Gibt ein in der VMM-Bibliothek gespeichertes Skriptobjekt an, das 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 nicht 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 als Konto an, mit dem der Computer bereitgestellt 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 Hostprofil 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 eine ID für eine Reihe von Befehlen an, die direkt vor dem letzten Befehl ausgeführt werden, der die gleiche Auftragsgruppen-ID enthält.

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

-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

Gibt an, dass dieser Vorgang die Antwortdatei aus dem Hostprofil entfernt.

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

-RemoveGuiRunOnceCommands

Indient, dass dieser Vorgang die GUI Run Once Commands-Eigenschaft aus einem Hostprofil entfernt.

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

-VMHostNetworkAdapterProfile

Gibt ein Array von Hostnetzwerkadapterprofilobjekten an.

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

-VMHostProfile

Gibt ein Hostprofilobjekt des virtuellen Computers an.

Type:PhysicalComputerProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

HostProfile[]

Dieses Cmdlet gibt mindestens ein HostProfile-Objekt zurück.