< Back

Get-JCPolicyTargetSystem

Thu Jan 16, 2020 8:54 am

NAME Get-JCPolicyTargetSystem



SYNOPSIS

Returns all bound systems associated with a JumpCloud Policy within a JumpCloud tenant.





SYNTAX

Get-JCPolicyTargetSystem [-PolicyName] <System.String> [-ByName] [<CommonParameters>]



Get-JCPolicyTargetSystem [-PolicyID] <System.String> [<CommonParameters>]





DESCRIPTION

The Get-JCPolicyTargetSystem returns information about all bound systems associated with a JumpCloud Policy within

a JumpCloud tenant.





PARAMETERS

-ByName <System.Management.Automation.SwitchParameter>

Use the -ByName parameter when you want to query a specific policy. The -ByName SwitchParameter will set the

ParameterSet to 'ByName' which queries one JumpCloud policy at a time.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-PolicyID <System.String>

The PolicyID of the JumpCloud policy you wish to query.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-PolicyName <System.String>

The Name of the JumpCloud policy you wish to query.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String







OUTPUTS

System.Object







NOTES









-------------------------- Example 1 --------------------------



PS C:\\> Get-JCPolicyTargetSystem -PolicyId 123456789



Returns the bound Systems associated for a policy with the id of 123456789.

-------------------------- Example 2 --------------------------



PS C:\\> Get-JCPolicyTargetSystem -PolicyName 'HelloWorld'



Returns the bound Systems associated for a policy with the name of HelloWorld.

-------------------------- Example 3 --------------------------



PS C:\\> Get-JCPolicy | Get-JCPolicyTargetSystem



Returns all policies within a JumpCloud tenant and the bound systems associated to those policies.



RELATED LINKS

Online Version: https://github.com/TheJumpCloud/support ... rgetSystem