## PowerCLI Reference

# New-VMHostProfile

## Synopsis

This cmdlet creates a new host profile based on a reference host.

Syntax

New-VMHostProfile [-Name] <String> [-ReferenceHost] <VMHost> [-Description <String>] [-CompatibilityMode] [-Server <VIServer[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Online version
Invoke-VMHostProfile
Export-VMHostProfile
Get-VMHostProfile
Import-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile
Test-VMHostProfileCompliance

Detailed 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 object

Notes

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.

Copyright © VMware, Inc. All rights reserved.