Dela via

Set-SCVMHostProfile

  • Referens
Modul:
VirtualMachineManager

Ändrar egenskaperna för en värdprofil.

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

Cmdleten Set-SCVMHostProfile ändrar egenskaperna för en värdprofil.

Om du vill ha information om hur du skapar en värdprofil skriver du Get-Help New-SCVMHostProfile -Detailed.

Exempel

Exempel 1: Ange tidszonsvärdet för en angiven värdprofil

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

Det här kommandot hämtar värdprofilobjektet med namnet HostProfile01 och anger dess tidszonsvärde till tidszonen USA, östra (035).

Exempel 2: Lägg till en profil för värdnätverkskort till en värdprofil

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

Det första kommandot hämtar värdprofilobjektet med namnet HostProfile01 och lagrar objektet i variabeln $VMHostProfile.

Det andra kommandot hämtar profilobjektet för värdnätverkskortet med ID:t 259f47c7-c5a9-429d-a421-d232f9b34991 och lagrar objektet i variabeln $HostNetAdapterProf.

Det sista kommandot lägger till profilen för värdnätverkskort som lagras i $HostNetAdapterProf till HostProfile01.

Parametrar

-AnswerFile

Anger ett skriptobjekt som lagras i VMM-biblioteket som ska användas som svarsfil. Namnet på svarsfilskriptet beror på vilket operativsystem du vill installera på en virtuell dator:

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

-Baseline

Anger en matris med baslinjeobjekt .

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

-BypassVHDConversion

Anger om en dynamisk virtuell hårddisk som är kopplad till en värdprofil inte konverteras till en fast typ under distributionen.

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

-CodeIntegrityPolicy

Anger en kodintegritetsprincip.

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

-ComputerAccessRunAsAccount

Anger den dator som kör som-kontot ska använda för att distribuera datorn. Det här Kör som-kontot läggs till på datorn som lokal administratör och används för att hantera datorn.

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

-Description

Anger en beskrivning av värdprofilen.

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

-DiskConfiguration

Anger disk- och partitionskonfigurationen för den fysiska dator som ska distribueras med Windows Hyper-V.

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

-Domain

Anger ett fullständigt kvalificerat domännamn (FQDN) för en Active Directory-domän.

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

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

-DomainJoinRunAsAccount

Anger ett Kör som-konto som har behörighet att ansluta till den angivna domänen.

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

-DriverMatchingTag

Anger de anpassade taggarna som ska matcha drivrutinsegenskaperna under distributionen. När taggar anges matchar distributionsprocessen de taggar som anges i värdprofilen med taggarna i drivrutinerna för att ladda ned matchande drivrutiner och installera dem i målbilden.

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

-FullName

Anger namnet på den person i vars namn en virtuell dator har registrerats.

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

-GuiRunOnceCommands

Anger en matris med kommandon som ska läggas till i avsnittet [GuiRunOnce] i en obevakad svarsfil. Använd enkla citattecken runt varje sträng som omges av dubbla citattecken.

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

Om du vill ha information om hur Windows PowerShell använder citattecken skriver du Get-Help about_Quoting_Rules.

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

-IsGuarded

Anger att värden måste vara en skyddad värd.

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

-JobGroup

Anger ett ID för en serie kommandon som ska köras som en uppsättning precis innan det sista kommandot som innehåller samma jobbgrupps-ID körs.

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

-JobVariable

Anger att jobb förloppet spåras och lagras i variabeln med namnet av den här parametern.

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

-LocalAdministratorCredential

Anger användarnamn och lösenord för det lokala administratörskontot (eller Linux-rotkontot om det gäller en Linux-kompatibel gästoperativsystemprofil).

Om du anger autentiseringsuppgifter för en ny eller befintlig mall, på en ny eller befintlig gästoperativsystemprofil eller på en ny virtuell dator åsidosätts alla befintliga administratörslösenord.

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

-Name

Anger namnet på ett VMM-objekt.

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

-OrganizationName

Anger namnet på organisationen för den person i vars namn en virtuell dator har registrerats.

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

-Owner

Anger ägaren av ett VMM-objekt i form av ett giltigt domänanvändarkonto.

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

-ProductKey

Anger en produktnyckel. Produktnyckeln är ett 25-siffrigt nummer som identifierar produktlicensen. En produktnyckel kan användas för att registrera VMM eller ett operativsystem som ska installeras på en virtuell dator eller värd.

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

-PROTipID

Anger ID för tipset om prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RemoveAnswerFile

Anger att den här åtgärden tar bort svarsfilen från värdprofilen.

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

-RemoveGuiRunOnceCommands

Anger att den här åtgärden tar bort egenskapen KÖR EN GÅNG-kommandon för GUI från en värdprofil.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-TimeZone

Anger ett tal (ett index) som identifierar en geografisk region som delar samma standardtid. En lista över tidszonsindex finns i Microsoft Time Zone Index Values på http://go.microsoft.com/fwlink/?LinkId=120935. Om ingen tidszon anges är standardtidszonen som används för en virtuell dator samma tidszonsinställning som finns på den virtuella datorvärden.

Exempelformat för att ange gmt-standardtidszonen: -TimeZone 085

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

-VirtualHardDisk

Anger ett virtuellt hårddiskobjekt.

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

-VMHostNetworkAdapterProfile

Anger en matris med profilobjekt för värdnätverkskort.

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

-VMHostProfile

Anger ett värdprofilobjekt för en virtuell dator.

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

-VMMServer

Anger ett VMM-serverobjekt.

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

-VMPaths

Anger en uppsättning standardsökvägar (som strängar avgränsade med pipelineoperatorn) på en värd där filer för virtuella datorer kan lagras.

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

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

Utdata

HostProfile[]

Den här cmdleten returnerar ett eller flera HostProfile-objekt .