Find-LXC1Devices
This cmdlet directly discovers manageable devices by specifying an individual IP addresses or FQDN, range of IP addresses, or subnet.
Note
When discovering a large number of devices, multiple requests are generated.
You cannot pipe objects to this cmdlet.
Syntax
Find-LXC1Devices -ManagerID String
-Hosts String[]
[-Connection LXC1Connection]
[CommonParameter]
Find-LXC1Devices -ManagerID String
-RangeStart String
-RangeEnd String
[-Connection LXC1Connection]
[CommonParameter]
Find-LXC1Devices -ManagerID String
-SubnetIPAddress String
-SubnetMask String
[-Connection LXC1Connection]
[CommonParameter]
Parameters
- -ManagerID String
- Specifies the ID of the Lenovo XClarity One Hub.
- -Hosts String[]
- Specifies one or more individual IP addresses or FQDNs for the devices to be discovered
- -RangeStart String
- Specifies the start IP address of a range for the devices to be discovered
- -RangeEnd String
- Specifies the end IP address of a range for the devices to be discovered
- -SubnetIPAddress String
- Specifies the subnet IP address from where the devices are to be discovered
- -SubnetMask String
- Specifies the subnet mask
- -Connection LXC1Connection
- Specifies the connection to the XClarity One server. If no connection is specified, the result from the last Connect-LXC1 cmdlet is used.
- 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
System.String[]
This cmdlet returns a string that contains the ID of the job or a string array that contains IDs for all jobs that were created for the request.
Lenovo.XC1.PowerShell.Automation.Data.RequestStatusMessage
If the request fails, an RequestStatusMessage object is returned with failure details.
Examples
The following example starts the discovery job for the specified devices.
param (
[Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] $ClientID,
[Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] $UserSecret
)
$securePassword = ConvertTo-SecureString $UserSecret -AsPlainText -Force
$cred = New-Object System.Management.Automation.PSCredential($ClientID, $securePassword))
$hostOnprem = "192.0.2.0"
$connection = Connect-LXC1 -PortalAddress $hostOnprem `
-Credential $cred `
-PortalType cloud `
-SkipCertificateCheck
$result = Find-LXC1Devices -Hosts "10.21.6.130","10.21.2.64" -ManagerID D0B59E15309447928C11AF7D84730D0E
$result
The following example starts the discovery job for the devices in the speciifed range.
param (
[Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] $ClientID,
[Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] $UserSecret
)
$securePassword = ConvertTo-SecureString $UserSecret -AsPlainText -Force
$cred = New-Object System.Management.Automation.PSCredential($ClientID, $securePassword))
$hostOnprem = "192.0.2.0"
$connection = Connect-LXC1 -PortalAddress $hostOnprem `
-Credential $cred `
-PortalType cloud `
-SkipCertificateCheck
$result = Find-LXC1Devices -ManagerID D0B59E15309447928C11AF7D84730D0E -RangeStart 10.21.2.64 -RangeEnd 10.21.6.130
$result
The following example starts the discovery job for the devices in the speciifed subnet.
param (
[Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] $ClientID,
[Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] $UserSecret
)
$securePassword = ConvertTo-SecureString $UserSecret -AsPlainText -Force
$cred = New-Object System.Management.Automation.PSCredential($ClientID, $securePassword))
$hostOnprem = "192.0.2.0"
$connection = Connect-LXC1 -PortalAddress $hostOnprem `
-Credential $cred `
-PortalType cloud `
-SkipCertificateCheck
$result = Find-LXC1Devices -ManagerID D0B59E15309447928C11AF7D84730D0E -SubnetIPAddress 10.71.32.0 -SubnetMask 255.255.255.128
$result
Give documentation feedback