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 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.
- -Groups String[]
- Specifies a list of ID of the resource managers or device groups, separated by a comma.
- -DeviceUUIDs String[]
- Specifies a 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.LXCOJobFullData
If the request was accepted the orchestrator server, this cmdlet returns an LXCOJobFullData object that contains the status of the operation that is associated with this request. If available, job logs are added to the root job and subtasks.
- 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 documentation feedback