Set-SCVMHostProfile

Modifies the properties of a host profile.

Syntax

Set-SCVMHostProfile [[-Name] <String>] [-AnswerFile <Script>] [-Baseline <Baseline[]>]
 [-BypassVHDConversion <Boolean>] [-CodeIntegrityPolicy <CodeIntegrityPolicy>]
 [-ComputerAccessRunAsAccount <RunAsAccount>] [-Description <String>] [-DiskConfiguration <String>]
 [-Domain <String>] [-DomainJoinRunAsAccount <RunAsAccount>]
 [-DriverMatchingTag <System.Collections.Generic.List`1[System.String]>] [-FullName <String>]
 [-GuiRunOnceCommands <String[]>] [-IsGuarded <Boolean>] [-JobGroup <Guid>] [-JobVariable <String>]
 [-LocalAdministratorCredential <VMMCredential>] [-OrganizationName <String>] [-Owner <String>]
 [-PROTipID <Guid>] [-ProductKey <String>] [-RemoveAnswerFile] [-RemoveGuiRunOnceCommands] [-RunAsynchronously]
 [-TimeZone <Int32>] [-VMHostNetworkAdapterProfile <PhysicalComputerNetworkAdapterProfile[]>]
 -VMHostProfile <PhysicalComputerProfile> [-VMMServer <ServerConnection>] [-VMPaths <String>]
 [-VirtualHardDisk <VirtualHardDisk>] [<CommonParameters>]

Description

The Set-SCVMHostProfile cmdlet modifies the properties of a host profile.

For information about how to create a host profile, type Get-Help New-SCVMHostProfile -Detailed.

Examples

Example 1: Set the time zone value for a specified host profile

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

This command gets the host profile object named HostProfile01 and sets its time zone value to the U.S. Eastern time zone (035).

Example 2: Add a host network adapter profile to a host profile

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

The first command gets the host profile object named HostProfile01 and stores the object in the $VMHostProfile variable.

The second command gets the host network adapter profile object with the ID of 259f47c7-c5a9-429d-a421-d232f9b34991 and stores the object in the $HostNetAdapterProf variable.

The last command adds the host network adapter profile stored in $HostNetAdapterProf to HostProfile01.

Parameters

-AnswerFile

Specifies a script object stored in the VMM library to use as an answer file. The name of the answer file script depends on the operating system that you want to install on a virtual machine:

- Sysprep.inf. Windows XP, Windows Server 2000, or Windows Server 2003

  • Unattend.xml. Windows Vista, Windows 7, or Windows Server 2008

Type:Script
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Baseline

Specifies an array of Baseline objects.

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

Indicates whether a dynamic VHD attached to a host profile is not converted to a fixed type during deployment.

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

Specifies a code integrity policy.

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

Specifies the computer access Run As account to use to deploy the computer. This Run As account will be added to the machine as a local administrator and used to manage the machine.

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

Specifies a description for the host profile.

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

Specifies the disk and partition configuration for the physical computer that is to be deployed with Windows Hyper-V.

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

Specifies a fully qualified domain name (FQDN) for an Active Directory domain.

Example format: -Domain "Domain01.Corp.Contoso.com"

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

Specifies a Run As account that has permission to join the specified domain.

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

Specifies the custom tags to match with driver properties during deployment. When tags are specified, the deployment process matches the tags specified in the host profile with the tags in the drivers in order to download matching drivers and install them in the target image.

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

Specifies the name of the person in whose name a virtual machine is registered.

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

Specifies an array of commands to add to the [GuiRunOnce] section of an unattended answer file. Use single quotation marks around each string enclosed in double quotation marks.

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

For information about how Windows PowerShell uses quotation marks, type Get-Help about_Quoting_Rules.

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

Indicates that the host needs to be a Guarded Host.

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

Specifies an ID for a series of commands that will run as a set just before the final command that includes the same job group ID runs.

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

Specifies that job progress is tracked and stored in the variable named by this parameter.

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

Specifies the user name and password for the Local Administrator account (or Linux root account in the case of a Linux-compatible Guest Operating System profile).

Specifying credentials on a new or existing template, on a new or existing guest operating system profile, or on a new virtual machine overrides any existing Administrator password.

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

Specifies the name of a VMM object.

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

Specifies the name of the organization for the person in whose name a virtual machine is registered.

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

Specifies the owner of a VMM object in the form of a valid domain user account.

- Example format: -Owner "Contoso\PattiFuller"

  • Example format: -Owner "PattiFuller@Contoso"

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

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

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

Specifies a product key. The product key is a 25-digit number that identifies the product license. A product key can be used to register VMM or an operating system to be installed on a virtual machine or host.

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

Indicates that this operation removes the answer file from the host profile.

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

Indiates that this operation removes the GUI Run Once Commands property from a host profile.

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

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

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

Specifies a number (an index) that identifies a geographical region that shares the same standard time. For a list of time zone indexes, see Microsoft Time Zone Index Values at http://go.microsoft.com/fwlink/?LinkId=120935. If no time zone is specified, the default time zone used for a virtual machine is the same time zone setting that is on the virtual machine host.

Example format to specify the GMT Standard Time zone: -TimeZone 085

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

Specifies an array of host network adapter profile objects.

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

Specifies a virtual machine host profile object.

Type:PhysicalComputerProfile
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VMPaths

Specifies a set of default paths (as strings separated by the pipeline operator) on a host where virtual machine files can be stored.

Example format: -VMPaths "C:\Folder1|C:\Folder2|C:\Folder3"

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

Specifies a virtual hard disk object.

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

Outputs

HostProfile[]

This cmdlet returns one or more **HostProfile** objects.