Join-LXCOServerConfigPattern
This cmdlet assigns a configuration pattern to specified device.
Note
You cannot pipe objects to this cmdlet.
Syntax
Join-LXCOServerConfigPattern [-Connection LXCOConnection]
-DeviceUUIDs String[]
-PatternID String
[-Overwrite]
[CommonParameter]
Join-LXCOServerConfigPattern [-Connection LXCOConnection]
-Groups String[]
-PatternID String
[-Overwrite]
[CommonParameter]
Join-LXCOServerConfigPattern [-Connection LXCOConnection]
-AllServers
-PatternID String
[-Overwrite]
[CommonParameter]
Parameters
- -Connection LXCAConnection
- Specifies the connection to the Lenovo XClarity Orchestrator server. If no connection is specified, the result from the last Connect-LXCO cmdlet is used.
- -Groups String
- Specifies list of IDs of manager or device groups.
- -DeviceUUIDs String[]
- Specifies list of UUIDs of managed devices, separated by a comma.
- -PatternID String
- Specifies the configuration-pattern ID.
- -AllServers
- If specified, the configuration pattern is assigned to all managed servers.
- -Overwrite
- When specified, if another pattern is assigned to that device, the current assigned pattern is replaced with the new policy.
If not specified, the current assigned pattern (if any) is not changed.
- 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.LXCOJob
If the request was accepted by the orchestrator server, this cmdlet returns an LXCOJob object that contains the status of the request.
- Lenovo.XClarityOrchestrator.PowerShell.Data.RequestStatusMessage
If the configuration-pattern was not assigned to all target devices, this cmdlet returns a RequestStatusMessage object that contains information about the devices that were not assigned.
If an error occurred, this cmdlet returns a RequestStatusMessage object that contains information about the reason of the failure.
Examples
The following example assigns a pattern to a specific device, replacing the existing pattern.
$cred = Get-Credential
Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck
$result = Join- LXCOServerConfigPattern
-DeviceUUIDs 00632D78DE644E23B712E200FE449787,349D0AD7A3AF11EA9F5F994620EB76C6 `
-PatternID 7757e42210003`
-Overwrite
Disconnect-LXCO
The following example assigns a pattern to all managed devices, replacing the existing pattern.
$cred = Get-Credential
Connect-LXCO -HostUri 192.0.2.0 -Credential $cred -SkipCertificateCheck
$result = Join- LXCOServerConfigPattern -PatternID 7757e42210003 `
-AllServers `
-Overwrite
Disconnect-LXCO
Give feedback