PowerCLI Reference

Export-VMHostProfile

Synopsis

This cmdlet exports the specified host profile to a file.

Syntax

Export-VMHostProfile [-FilePath] <String> [-Profile] <VMHostProfile> [-Force] [-Server <VIServer>] [<CommonParameters>]

Related Commands

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

Detailed Description

This cmdlet exports the specified host profile to a file that is in the VMware profile format (.vpf). If the value of the Force parameter is $false and the destination file exists or the target parent directory does not exist, a terminating error is generated. If the value of the Force parameter is $true, the existing destination file is overwritten and directories are created to complete the specified file path.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
FilePathStringSpecifies the path to the file where you want to export the host profile.trueFalse
ProfileVMHostProfileSpecifies the host profile you want to export.trueTrue (ByValue)
ForceSwitchParameterIndicates that the cmdlet overwrites the existing destination files and creates directories to complete the specified file path.falseFalse
ServerVIServerSpecifies 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.falseFalse

Return Type

Zero or more FileInfo objects

Notes

Examples

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

$profile = (Get-VMHostProfile -Name Profile )[0]

Export-VMHostProfile -FilePath export.prf -Profile $profile -Force

Exports the selected host profile to the export.prf file.


Copyright © VMware, Inc. All rights reserved.