Syntax
New-VMHostProfile [-Name] <String> [-ReferenceHost] <VMHost> [-CompatibilityMode] [-Description <String>] [-Server <VIServer[]>] [-Confirm] [-WhatIf] [<CommonParameters>]Related Commands
Online VersionDetailed Description
This cmdlet creates a new host profile based on a reference host.Parameters
| Name | Type | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|---|
| Name | String | Specifies a name for the new host profile. | true | False | |
| ReferenceHost | VMHost | Specifies the reference host, on which the new virtual machine host profile is based. | true | True (ByValue) | |
| CompatibilityMode | SwitchParameter | If you are connected to a vCenter Server/ESX 5.0 or later, use this parameter to indicate that you want the new profile to be compatible with hosts running ESX/vCenter Server versions earlier than 5.0. | false | False | |
| Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | False | |
| Description | String | Provides a description for the new host profile. | false | False | |
| Server | VIServer[] | Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. | false | True (ByValue) | |
| WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | False |
Return Type
The newly created VMHostProfile objectNotes
Examples
-------------------------- Example 1 --------------------------
$h = Get-VMHost 10.23.134.133 New-VMHostProfile -Name testProfile -Description "This is my first test profile." -ReferenceHost $h
Creates a profile based on the virtual machine host with an IP address 10.23.134.133.