Freigeben über

Set-SCVMHostProfile

Modul:
VirtualMachineManager Module

Ändert die Eigenschaften eines Hostprofils.

Syntax

Default (Standardwert) 

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

Mit dem Cmdlet Set-SCVMHostProfile werden die Eigenschaften eines Hostprofils geändert.

Weitere Informationen zum Erstellen eines Hostprofils erhalten Sie, wenn Sie Get-Help New-SCVMHostProfile -Detailedeingeben.

Beispiele

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

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

Mit diesem Befehl wird das Hostprofilobjekt mit dem Namen HostProfile01 abgerufen und der Zeitzonenwert auf die Zeitzone "U.S. Eastern Time" (035) festgelegt.

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 mit dem Namen HostProfile01 ab und speichert das Objekt in der Variablen $VMHostProfile.

Der zweite Befehl ruft das Profilobjekt des Hostnetzwerkadapters mit der ID 259f47c7-c5a9-429d-a421-d232f9b34991 ab und speichert das Objekt in der Variablen $HostNetAdapterProf.

Mit dem letzten Befehl wird das in $HostNetAdapterProf gespeicherte Hostnetzwerkadapterprofil HostProfile01 hinzugefügt.

Parameter

-AnswerFile

Gibt ein Skriptobjekt an, das in der VMM-Bibliothek gespeichert ist und als Antwortdatei verwendet werden soll. Der Name des Antwortdateiskripts hängt vom Betriebssystem ab, das Sie auf einem virtuellen Computer installieren möchten:

  • Sysprep.inf. Windows XP, Windows Server 2000 oder Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 oder Windows Server 2008

Parametereigenschaften

Typ:Script
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Baseline

Gibt ein Array von Baseline-Objekten an.

Parametereigenschaften

Typ:

Baseline[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CodeIntegrityPolicy

Gibt eine Codeintegritätsrichtlinie an.

Parametereigenschaften

Typ:CodeIntegrityPolicy
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ComputerAccessRunAsAccount

Gibt das ausführende Konto für den Computerzugriff an, das zum Bereitstellen des Computers verwendet werden soll. Dieses ausführende Konto wird dem Computer als lokaler Administrator hinzugefügt und zum Verwalten des Computers verwendet.

Parametereigenschaften

Typ:RunAsAccount
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für das Hostprofil an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DiskConfiguration

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Domain

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

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DomainJoinRunAsAccount

Gibt ein ausführendes Konto an, das über die Berechtigung zum Beitritt zur angegebenen Domäne verfügt.

Parametereigenschaften

Typ:RunAsAccount
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DriverMatchingTag

Gibt die benutzerdefinierten Tags an, die während der Bereitstellung mit den Treibereigenschaften abgeglichen werden sollen. Wenn Tags angegeben werden, gleicht der Bereitstellungsprozess die im Hostprofil angegebenen Tags mit den Tags in den Treibern ab, um entsprechende Treiber herunterzuladen und im Zielimage zu installieren.

Parametereigenschaften

Typ:

System.Collections.Generic.List`1[System.String]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FullName

Gibt den Namen der Person an, in der ein virtueller Computer registriert ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GuiRunOnceCommands

Gibt ein Array von Befehlen an, die dem [GuiRunOnce] Abschnitt 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 Get-Help about_Quoting_Rulesein.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IsGuarded

Gibt an, dass es sich bei dem Host um einen geschützten Host handeln muss.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobGroup

Gibt eine ID für eine Reihe von Befehlen an, die als Satz ausgeführt werden, kurz bevor der letzte Befehl ausgeführt wird, der dieselbe Auftragsgruppen-ID enthält.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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, ein neues oder vorhandenes Gastbetriebssystemprofil angeben, oder auf einem neuen virtuellen Computer werden alle vorhandenen Administratorkennwörter außer Kraft gesetzt.

Parametereigenschaften

Typ:VMMCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen eines VMM-Objekts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OrganizationName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Owner

Gibt die besitzende Person eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProductKey

Gibt einen Product Key an. Der Product Key ist eine 25-stellige Nummer, die die Produktlizenz identifiziert. Ein Product Key kann verwendet werden, um VMM oder ein Betriebssystem zu registrieren, das auf einem virtuellen Computer oder Host installiert werden soll.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RemoveAnswerFile

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RemoveGuiRunOnceCommands

Gibt an, dass dieser Vorgang die GUI-Eigenschaft "Einmal ausgeführte Befehle" aus einem Hostprofil entfernt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TimeZone

Gibt eine Zahl (einen Index) an, die eine geografische Region identifiziert, die die gleiche 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 wird, ist die standardzeitzone, die für einen virtuellen Computer verwendet wird, dieselbe Zeitzoneneinstellung, die sich auf dem Host des virtuellen Computers befindet.

Beispielformat zum Angeben der GMT-Standardzeitzone: -TimeZone 085

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualHardDisk

Gibt ein virtuelles Festplattenobjekt an.

Parametereigenschaften

Typ:VirtualHardDisk
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHostNetworkAdapterProfile

Gibt ein Array von Profilobjekten für Hostnetzwerkadapter an.

Parametereigenschaften

Typ:

PhysicalComputerNetworkAdapterProfile[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHostProfile

Gibt ein Hostprofilobjekt für virtuelle Maschinen an.

Parametereigenschaften

Typ:PhysicalComputerProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMPaths

Gibt eine Reihe von Standardpfaden (als Zeichenfolgen, die durch den Pipelineoperator getrennt sind) auf einem Host an, auf dem Dateien virtueller Computer gespeichert werden können.

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

HostProfile

Dieses Cmdlet gibt ein oder mehrere HostProfile-Objekte zurück.