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

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameStringSpecifies a name for the new host profile.truefalse
ReferenceHostVMHostSpecifies 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
DescriptionStringProvides a description for the new host profile.falsefalse
ServerVIServer[]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.falsetrue (ByValue)
WhatIfSwitchParameterIndicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse

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.