Set-SCVMHostProfile
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_Rules
gebruikt.
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 .