< Back
Test-VMHostProfileCompliance
Post
NAME Test-VMHostProfileCompliance
SYNOPSIS
This cmdlet tests hosts for profile compliance.
SYNTAX
Test-VMHostProfileCompliance [-Profile] <VMHostProfile[]> [[-Server] <VIServer[]>] [-UseCache] [<CommonParameters>]
Test-VMHostProfileCompliance [-VMHost] <VMHost[]> [[-Server] <VIServer[]>] [-UseCache] [<CommonParameters>]
DESCRIPTION
This cmdlet tests hosts for profile compliance. The Profile and VMHost parameters cannot be set at the same time.
If the Profile parameter is set, the specified host profile is tested for compliance with the hosts, to which it
is associated. If the VMHost parameter is specified, the host is tested for compliance with the profiles
associated with it. If no profiles are associated with the host, then the profile associated with the cluster is
applied.
PARAMETERS
-Profile <VMHostProfile[]>
Specifies a host profile against which to test the specified host for compliance with the host to which it is
associated. Do not set this parameter if the VMHost parameter is set.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Server <VIServer[]>
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this
parameter, the command runs on the default servers. For more information about default servers, see the
description of Connect-VIServer.
Required? false
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-UseCache [<SwitchParameter>]
Indicates that you want the vCenter Server to return cached information. If vCenter Server does not have
cached information, a compliance scanning is performed.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-VMHost <VMHost[]>
Specifies the host you want to test for profile compliance with the profile associated with it. If no profile
is associated with it, the host is tested for compliance with the profile associated with the cluster, to
which the host belongs. Do not set this parameter if the Profile parameter is set.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? true
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Zero or more VMHostProfileIncompliance objects
NOTES
-------------------------- Example 2 --------------------------
Test-VMHostProfileCompliance -VMHost Host
Tests the specified host for compliance with the profiles associated with it.
-------------------------- Example 3 --------------------------
$profile = Get-VMHostProfile -Name Profile
Apply-VMHostProfile -AssociateOnly -Profile $profile -Entity 10.0.0.126
Test-VMHostProfileCompliance -VMHost 10.0.0.126 | fl *
Test the profile compliance of a non-compliant virtual machine host associated with the profile.
-------------------------- Example 4 --------------------------
Test-VMHostProfileCompliance -Profile $profile | fl *
Test the profile compliance of a virtual machine host profile with the hosts it is associated with.
RELATED LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... iance.html
Invoke-VMHostProfile
Export-VMHostProfile
Get-VMHostProfile
Import-VMHostProfile
New-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile
SYNOPSIS
This cmdlet tests hosts for profile compliance.
SYNTAX
Test-VMHostProfileCompliance [-Profile] <VMHostProfile[]> [[-Server] <VIServer[]>] [-UseCache] [<CommonParameters>]
Test-VMHostProfileCompliance [-VMHost] <VMHost[]> [[-Server] <VIServer[]>] [-UseCache] [<CommonParameters>]
DESCRIPTION
This cmdlet tests hosts for profile compliance. The Profile and VMHost parameters cannot be set at the same time.
If the Profile parameter is set, the specified host profile is tested for compliance with the hosts, to which it
is associated. If the VMHost parameter is specified, the host is tested for compliance with the profiles
associated with it. If no profiles are associated with the host, then the profile associated with the cluster is
applied.
PARAMETERS
-Profile <VMHostProfile[]>
Specifies a host profile against which to test the specified host for compliance with the host to which it is
associated. Do not set this parameter if the VMHost parameter is set.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Server <VIServer[]>
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this
parameter, the command runs on the default servers. For more information about default servers, see the
description of Connect-VIServer.
Required? false
Position? 2
Default value None
Accept pipeline input? False
Accept wildcard characters? true
-UseCache [<SwitchParameter>]
Indicates that you want the vCenter Server to return cached information. If vCenter Server does not have
cached information, a compliance scanning is performed.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-VMHost <VMHost[]>
Specifies the host you want to test for profile compliance with the profile associated with it. If no profile
is associated with it, the host is tested for compliance with the profile associated with the cluster, to
which the host belongs. Do not set this parameter if the Profile parameter is set.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? true
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Zero or more VMHostProfileIncompliance objects
NOTES
-------------------------- Example 2 --------------------------
Test-VMHostProfileCompliance -VMHost Host
Tests the specified host for compliance with the profiles associated with it.
-------------------------- Example 3 --------------------------
$profile = Get-VMHostProfile -Name Profile
Apply-VMHostProfile -AssociateOnly -Profile $profile -Entity 10.0.0.126
Test-VMHostProfileCompliance -VMHost 10.0.0.126 | fl *
Test the profile compliance of a non-compliant virtual machine host associated with the profile.
-------------------------- Example 4 --------------------------
Test-VMHostProfileCompliance -Profile $profile | fl *
Test the profile compliance of a virtual machine host profile with the hosts it is associated with.
RELATED LINKS
Online Version: https://code.vmware.com/doc/preview?id= ... iance.html
Invoke-VMHostProfile
Export-VMHostProfile
Get-VMHostProfile
Import-VMHostProfile
New-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile