Get-LXCOResourcesCompliance
This cmdlet returns information about the firmware compliances for managed devices or registered resource managers.
Note
You cannot pipe objects to this cmdlet.
Syntax
Get-LXCOResourcesCompliance [-Connection LXCOConnection]
-ResourceManagers
[-Status String[]]
[-ComplianceStatus String[]]
[-Name String[]]
[-InstalledVersion String[]]
[-BuildNumber String[]]
[-AssignedCompliancePolicy String[]]
[-ComplianceTarget String[]]
[-ComplianceTargetBuildNumber String[]]
[-Groups String[]]
[CommonParameters]
Get-LXCOResourcesCompliance [-Connection LXCOConnection]
-Devices
[-Status String[]]
[-ComplianceStatus String[]]
[-Name String[]]
[-InstalledVersion String[]]
[-BuildNumber String[]]
[-AssignedCompliancePolicy String[]]
[-ComplianceTarget String[]]
[-ComplianceTargetBuildNumber String[]]
[-Groups String[]]
[-Connectivity String[]]
[-ProductName String[]]
[-MachineType String[]]
[-SerialNumber String[]]
[CommonParameters]
Parameters
- -Connection LXCOConnection
- Specifies the connection to the Lenovo XClarity Orchestrator server. If no connection is specified, the result from the last Connect-LXCO cmdlet is used.
- -ResourceManagers
- When specified, this cmdlet returns updates-compliance details for registered resource managers
- -Devices
- When specified, this cmdlet returns firmware-compliance details for managed devices
- -Status String[]
- Specifies the status of the devices or managers to be returned. This can be one or more of the following values, separated by comma.
- Critical
- Normal
- Warning
- Unknown
- -ComplianceStatus String[]
- Specifies the compliance status of the devices or managers to be returned. This can be one or more of the following values, separated by comma.
- CalculatingPolicy
- Compliant
- NoPolicyAssigned
- NotCompliant
- -Name String[]
- Specifies a list of full or partial name text. All devices or resource managers that contain the specified pattern are returned.
- -InstalledVersion String[]
- Specifies a list of full or partial version number for updates' components. All devices or resource managers that contain the specified pattern are returned.
- -BuildNumber String[]
- Specifies a list of full or partial version build number (identifier) for updates' components. All devices or resource managers that contain the specified pattern are returned.
- -AssignedCompliancePolicy String[]
- Specifies a list of full or partial compliance policy names. All devices or resource managers that contain the specified pattern are returned.
- -ComplianceTarget String[]
- Specifies a list of full or partial version number for target in updates' components. All devices or resource managers that contain the specified pattern are returned..
- -ComplianceTargetBuildNumber String[]
- Specifies a list of full or partial build number (identifier) for target in updates' components. All devices or resource managers that contain the specified pattern are returned.
- -Groups String[]
- Specifies one or more full or partial resource-group names, separated by a comma. All devices or resource managers that contain the specified pattern are returned.
- -Connectivity String[]
- Specifies the connectivity status of devices to return. This can be one or more of the following values, separated by a comma.
- Online
- Offline
- Partial
- -ProductName String[]
- Specifies one or more full or partial product names, separated by a comma. A list of all devices that match specified pattern is returned.
- -MachineType String[]
- Specifies one or more full or partial machine types, separated by a comma. A list of all devices that match specified pattern is returned.
- -SerialNumber String[]
- Specifies one or more full or partial serial numbers, separated by a comma. A list of all devices that match specified pattern is returned.
- CommonParameters
- This cmdlet supports the following common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable, -OutBuffer, -PipelineVariable, -OutVariable. For detailed information about each common parameter, see the Microsoft PowerShell Common Parameters webpage.
Results
- Lenovo.XClarityOrchestrator.PowerShell.Data.Devices.DeviceFirmwareComplianceDetails[]
If -Devices parameter is specified, this cmdlet returns a DeviceFirmwareComplianceDetails[] array that contains information about firmware compliance for managed devices.
- Lenovo.XClarityOrchestrator.PowerShell.Data.Devices.ResourceManagerUpdateComplianceDetails[]
If -ResouceManager is specified, this cmdlet returns a ResourceManagerUpdateComplianceDetails[] array that contains information about compliance status.
- Lenovo.XClarityOrchestrator.PowerShell.Data.RequestStatusMessage
If an error occurred, this cmdlet returns a RequestStatusMessage object that contains information about the reason of the failure.
Examples
The following example returns all devices that are not compliant or doesn't have a policy assigned and have Normal or Warning status.
$cred = Get-Credential
Connect-LXCO -HostUri "192.0.2.0" -Credential $Cred -SkipCertificateCheck
$details = Get-LXCOResourcesCompliance -Devices `
-ComplianceStatus NoPolicyAssigned,NotCompliant `
-Status Normal,Warning
# show the result
$details
Disconnect-LXCO
The following example returns all resource managers that doesn't have a policy assigned and have Critical status.
$cred = Get-Credential
Connect-LXCO -HostUri "192.0.2.0" -Credential $Cred -SkipCertificateCheck
$details = Get-LXCOResourcesCompliance -ResourceManagers `
-ComplianceStatus NoPolicyAssigned `
-Status Critical
# show the result
$details
Disconnect-LXCO
Give documentation feedback