--- external help file: JumpCloud-help.xml Module Name: JumpCloud online version: https://github.com/TheJumpCloud/support/wiki/Add-JCCommandTarget schema: 2.0.0 --- # Add-JCCommandTarget ## SYNOPSIS Associates a JumpCloud system or a JumpCloud system group with a JumpCloud command ## SYNTAX ### SystemID (Default) ``` Add-JCCommandTarget [-CommandID] [-SystemID] [] ``` ### GroupID ``` Add-JCCommandTarget [-CommandID] [-GroupID] [] ``` ### GroupName ``` Add-JCCommandTarget [-CommandID] [-GroupName] [] ``` ## DESCRIPTION The Add-JCCommandTarget function allows you to add JumpCloud systems or JumpCloud system groups to the target list of a specific JumpCloud command. Group associations can be made by system group name or system group ID system associations can only be made using the SystemID. When JumpCloud commands are run they target all the systems on their target list. ## EXAMPLES ### Example 1 ```powershell Add-JCCommandTarget -CommandID 5b99777710a3690ssisr3a1w -SystemID 5l0o2fu426041i79st3c35 ``` Adds the JumpCloud system with System ID '5l0o2fu426041i79st3c35' to the target list for the JumpCloud command with command ID '5b99777710a3690ssisr3a1w' ### Example 2 ```powershell Add-JCCommandTarget -CommandID 5b99777710a3690ssisr3a1w -GroupName WindowsMachines ``` Adds the JumpCloud system group 'WindowsMachines' and the systems within this group to the target list for the JumpCloud command with command ID '5b99777710a3690ssisr3a1w' ### Example 3 ```powershell Add-JCCommandTarget -CommandID 5b99777710a3690ssisr3a1w -GroupID 5j03458a232z115210z66913 ``` Adds the JumpCloud system group with the GroupID '5j03458a232z115210z66913' and the systems within this group to the target list for the JumpCloud command with command ID '5b99777710a3690ssisr3a1w' ## PARAMETERS ### -CommandID The id value of the JumpCloud command. Use the command "Get-JCCommand | Select-Object _id, name" to find the "_id" value for all the JumpCloud commands in your tenant. ```yaml Type: System.String Parameter Sets: (All) Aliases: _id, id Required: True Position: 0 Default value: None Accept pipeline input: True (ByPropertyName) Accept wildcard characters: False ``` ### -GroupID The id value of a JumpCloud system group ```yaml Type: System.Object Parameter Sets: GroupID Aliases: Required: True Position: 1 Default value: None Accept pipeline input: True (ByPropertyName) Accept wildcard characters: False ``` ### -GroupName The name of the JumpCloud system group. If the name includes a space enter the name within quotes. Example: -GroupName "The Space" ```yaml Type: System.Object Parameter Sets: GroupName Aliases: name Required: True Position: 1 Default value: None Accept pipeline input: True (ByPropertyName) Accept wildcard characters: False ``` ### -SystemID The _id of a JumpCloud system. To find the _id of all JumpCloud systems within your tenant run "Get-JCSystem | select _id, hostname" ```yaml Type: System.Object Parameter Sets: SystemID Aliases: Required: True Position: 1 Default value: None Accept pipeline input: True (ByPropertyName) Accept wildcard characters: False ``` ### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ### System.String ### System.Object ## OUTPUTS ### System.Object ## NOTES ## RELATED LINKS