powershellscripts.com

Tutorials  PowerShell Cmdlet Help for New-VMHostProfile



NAME
New-VMHostProfile

SYNOPSIS
Creates a new host profile based on a reference host.

SYNTAX
New-VMHostProfile [-Name] [-ReferenceHost] [-Description ] [-CompatibilityMode] [-Server
] [-WhatIf] [-Confirm] []


DESCRIPTION
Creates a new host profile based on a reference host.


PARAMETERS
-Name
Specify a name for the new host profile.

Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false

-ReferenceHost
Specify the reference host, on which the new virtual machine host profile is based.

Required? true
Position? 2
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true

-Description
Provide a description for the new host profile.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-CompatibilityMode
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.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Server
Specifies the vSphere server on which the cmdlet is run. If no value is given to this parameter, the command ru
ns on the server currently specified in the $DefaultVIServer variable

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true

-WhatIf
Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modi
fied.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Confirm
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.

Required? false
Position? named
Default value $true
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
VMHostProfile


NOTES




-------------- Example 1 --------------

C:\PS>$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.






RELATED LINKS
Online version: http://www.vmware.com/support/developer/PowerCLI/PowerCLI501/html/New-VMHostProfile.html
Apply-VMHostProfile
Export-VMHostProfile
Get-VMHostProfile
Import-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile
Test-VMHostProfileCompliance