vSphere PowerCLI Reference

New-VMHostProfile

Synopsis

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
Apply-VMHostProfile
Export-VMHostProfile
Get-VMHostProfile
Import-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile
Test-VMHostProfileCompliance

Detailed Description

Creates a new host profile based on a reference host.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameStringSpecify a name for the new host profile.truefalse
ReferenceHostVMHostSpecify the reference host, on which the new virtual machine host profile is based.truetrue (ByValue)
CompatibilityModeSwitchParameterIf 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.falsefalse
ConfirmSwitchParameterIf 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.falsefalse$true
DescriptionStringProvide a description for the new host profile.falsefalse
ServerVIServer[]Specifies the vSphere server on which the cmdlet is run. If no value is given to this parameter, the command runs on the server currently specified in the $DefaultVIServer variablefalsetrue (ByValue)
WhatIfSwitchParameterIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

Return Type

VMHostProfile

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 © 1998 - 2011 VMware, Inc. All rights reserved.