Delen via

Set-SCVMHostProfile

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een hostprofiel.

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

Description

De cmdlet Set-SCVMHostProfile wijzigt de eigenschappen van een hostprofiel.

Typ voor informatie over het maken van een hostprofiel Get-Help New-SCVMHostProfile -Detailed.

Voorbeelden

Voorbeeld 1: De tijdzonewaarde voor een opgegeven hostprofiel instellen

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

Met deze opdracht wordt het hostprofielobject met de naam HostProfile01 opgehaald en wordt de tijdzonewaarde ingesteld op de Amerikaanse oostelijke tijdzone (035).

Voorbeeld 2: Een hostnetwerkadapterprofiel toevoegen aan een hostprofiel

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

Met de eerste opdracht wordt het hostprofielobject met de naam HostProfile01 opgehaald en wordt het object opgeslagen in de $VMHostProfile variabele.

Met de tweede opdracht wordt het profielobject van de hostnetwerkadapter opgehaald met de id 259f47c7-c5a9-429d-a421-d232f9b34991 en wordt het object opgeslagen in de $HostNetAdapterProf variabele.

Met de laatste opdracht wordt het profiel van de hostnetwerkadapter toegevoegd dat is opgeslagen in $HostNetAdapterProf aan HostProfile01.

Parameters

-AnswerFile

Hiermee geeft u een scriptobject op dat is opgeslagen in de VMM-bibliotheek die moet worden gebruikt als antwoordbestand. De naam van het antwoordbestandsscript is afhankelijk van het besturingssysteem dat u wilt installeren op een virtuele machine:

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

-Baseline

Hiermee geeft u een matrix van basislijnobjecten op.

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

-BypassVHDConversion

Geeft aan of een dynamische VHD die is gekoppeld aan een hostprofiel niet wordt geconverteerd naar een vast type tijdens de implementatie.

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

-CodeIntegrityPolicy

Hiermee geeft u een code-integriteitsbeleid op.

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

-ComputerAccessRunAsAccount

Hiermee geeft u de computertoegang Uitvoeren als-account te gebruiken om de computer te implementeren. Dit Uitvoeren als-account wordt als lokale beheerder aan de computer toegevoegd en gebruikt om de computer te beheren.

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

-Description

Hiermee geeft u een beschrijving voor het hostprofiel.

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

-DiskConfiguration

Hiermee geeft u de schijf- en partitieconfiguratie op voor de fysieke computer die moet worden geïmplementeerd met Windows Hyper-V.

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

-Domain

Hiermee geeft u een FQDN (Fully Qualified Domain Name) voor een Active Directory-domein.

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

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

-DomainJoinRunAsAccount

Hiermee geeft u een Uitvoeren als-account dat gemachtigd is om lid te worden van het opgegeven domein.

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

-DriverMatchingTag

Hiermee geeft u de aangepaste tags op die overeenkomen met stuurprogramma-eigenschappen tijdens de implementatie. Wanneer tags worden opgegeven, komt het implementatieproces overeen met de tags die zijn opgegeven in het hostprofiel met de tags in de stuurprogramma's om overeenkomende stuurprogramma's te downloaden en te installeren in de doelinstallatiekopie.

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

-FullName

Hiermee geeft u de naam van de persoon in wiens naam een virtuele machine is geregistreerd.

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

-GuiRunOnceCommands

Hiermee geeft u een matrix van opdrachten toe te voegen aan de sectie [GuiRunOnce] van een antwoordbestand zonder toezicht. Gebruik enkele aanhalingstekens rond elke tekenreeks tussen dubbele aanhalingstekens.

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

Typ voor informatie over hoe Windows PowerShell aanhalingstekens Get-Help about_Quoting_Rulesgebruikt.

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

-IsGuarded

Geeft aan dat de host een beveiligde host moet zijn.

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

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

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

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

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

-LocalAdministratorCredential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor het lokale beheerdersaccount (of Linux-hoofdaccount in het geval van een linux-compatibel gastbesturingssysteemprofiel).

Als u referenties opgeeft voor een nieuwe of bestaande sjabloon, op een nieuw of bestaand profiel voor een gastbesturingssysteem, of op een nieuwe virtuele machine, wordt een bestaand beheerderswachtwoord overschreven.

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

-Name

Hiermee geeft u de naam van een VMM-object.

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

-OrganizationName

Hiermee geeft u de naam van de organisatie voor de persoon in wiens naam een virtuele machine is geregistreerd.

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

-Owner

Geeft de eigenaar van een VMM-object aan in de vorm van een geldig domeingebruikersaccount.

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

-ProductKey

Hiermee geeft u een productcode op. De productcode is een getal van 25 cijfers waarmee de productlicentie wordt geïdentificeerd. Een productcode kan worden gebruikt om VMM of een besturingssysteem te registreren dat moet worden geïnstalleerd op een virtuele machine of host.

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

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

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

-RemoveAnswerFile

Geeft aan dat met deze bewerking het antwoordbestand uit het hostprofiel wordt verwijderd.

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

-RemoveGuiRunOnceCommands

Hiermee verwijdert u de eigenschap Run Once Commands van de GUI uit een hostprofiel.

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

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

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

-TimeZone

Hiermee geeft u een getal (een index) dat een geografische regio identificeert die dezelfde standaardtijd deelt. Zie Microsoft Time Zone Index Values op voor een lijst met tijdzone-indexen op http://go.microsoft.com/fwlink/?LinkId=120935. Als er geen tijdzone is opgegeven, is de standaardtijdzone die wordt gebruikt voor een virtuele machine dezelfde tijdzone-instelling die zich op de host van de virtuele machine bevindt.

Voorbeeldindeling voor het opgeven van de gmt-standaardtijdzone: -TimeZone 085

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

-VirtualHardDisk

Hiermee geeft u een virtueel hardeschijfobject op.

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

-VMHostNetworkAdapterProfile

Hiermee geeft u een matrix van hostnetwerkadapterprofielobjecten.

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

-VMHostProfile

Hiermee geeft u een hostprofielobject voor virtuele machines op.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

-VMPaths

Hiermee geeft u een set standaardpaden (als tekenreeksen gescheiden door de pijplijnoperator) op een host waar bestanden van virtuele machines kunnen worden opgeslagen.

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

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

Uitvoerwaarden

HostProfile[]

Deze cmdlet retourneert een of meer HostProfile-objecten .