PowerCLI Reference

Get-VMHostProfile

Synopsis

This cmdlet retrieves the available host profiles.

Syntax

Get-VMHostProfile [[-Name] <String[]>] [-Description <String[]>] [-Entity <InventoryItem[]>] [-Id <String[]>] [-ReferenceHost <VMHost[]>] [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online Version
Invoke-VMHostProfile
Export-VMHostProfile
Import-VMHostProfile
New-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile
Test-VMHostProfileCompliance

Detailed Description

This cmdlet retrieves the available host profiles. A host profile encapsulates the host settings and helps to manage the host configuration.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameString[]Specifies the names of the host profiles you want to retrieve.falseFalse
DescriptionString[]Specifies a phrase from the description of the host profiles you want to retrieve.falseFalse
EntityInventoryItem[]Specifies inventory objects associated with the host profiles you want to retrieve.falseTrue (ByValue)
IdString[]Specifies the IDs of the host profiles you want to retrieve.


Note: When a list of values is specified for the Id parameter, the returned objects would have an ID that matches exactly one of the string values in that list.
falseFalse
ReferenceHostVMHost[]Specifies the reference hosts of the profiles you want to retrieve.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)

Return Type

Zero or more VMHostProfile objects

Notes

Examples

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

Get-VMHostProfile -Name Profile

Retrieves the virtual machine host profile named Profile.


Copyright © VMware, Inc. All rights reserved.