Get-SentinelOneAgentContentUpdates
SYNOPSIS
Gets various agent content updates.
SYNTAX
indexByType (Default)
Get-SentinelOneAgentContentUpdates [-typesOnly] [<CommonParameters>]
indexByMerged
Get-SentinelOneAgentContentUpdates -agentId <String> [-countOnly] [-cursor <String>] [-limit <Int64>] [-skip <Int64>]
[-skipCount] [-sortBy <String>] [-sortOrder <String>] [<CommonParameters>]
indexByExisting
Get-SentinelOneAgentContentUpdates [-accountIds <Int64[]>] [-siteIds <Int64[]>] [<CommonParameters>]
DESCRIPTION
The Get-SentinelOneAgentContentUpdates cmdlet gets various agent content updates that match the filters.
Calls the following endpoints: Get Agent Merged Updates /web/api/v2.1/content-updates-inventory
Get Content Updates Types (default return)
/web/api/v2.1/atlas-agents-control/hotfix-policy/asset-family-types
Get Existing Content Updates Policy
/web/api/v2.1/atlas-agents-control/hotfix-policy/policy
EXAMPLES
EXAMPLE 1
Get-SentinelOneAgentContentUpdates
Returns a list of agent components which can receive content updates
Calls the “/atlas-agents-control/hotfix-policy/asset-family-types” uri
EXAMPLE 2
Get-SentinelOneAgentContentUpdates -agentId 1234567890
Returns the defined agents merged updates.
Calls the “/content-updates-inventory” uri
EXAMPLE 3
Get-SentinelOneAgentContentUpdates -accountIds 1234567890
Returns the existing content updates policy
Calls the “/atlas-agents-control/hotfix-policy/policy” uri
PARAMETERS
-agentId
Returns agent content updates related to specified agentId
Example: “225494730938493804,225494730938493915”
Type: String
Parameter Sets: indexByMerged
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-accountIds
Returns accounts under the defined ids
Type: Int64[]
Parameter Sets: indexByExisting
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-countOnly
If true, only total number of items will be returned, without any of the actual objects.
Type: SwitchParameter
Parameter Sets: indexByMerged
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-cursor
Cursor position returned by the last request. Use to iterate over more than 1000 items.
Found under pagination
Example: “YWdlbnRfaWQ6NTgwMjkzODE=”.
Type: String
Parameter Sets: indexByMerged
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-limit
Limit number of returned items (1-10000).
Type: Int64
Parameter Sets: indexByMerged
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-siteIds
List of Site IDs to filter by
Example: “225494730938493804,225494730938493915”.
Type: Int64[]
Parameter Sets: indexByExisting
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-skip
Skip first number of items (0-1000). To iterate over more than 1000 items, use “cursor”.
Example: “150”.
Type: Int64
Parameter Sets: indexByMerged
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-skipCount
If true, total number of items will not be calculated, which speeds up execution time.
Type: SwitchParameter
Parameter Sets: indexByMerged
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-sortBy
Sorts the returned results by a defined value
Allowed values: ‘agentId’, ‘appliedAt’, ‘assetFamilyType’, ‘displayName’, ‘version’
Type: String
Parameter Sets: indexByMerged
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-sortOrder
Sort direction
Allowed values: ‘asc’, ‘desc’
Type: String
Parameter Sets: indexByMerged
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-typesOnly
Get a list of agent components which can receive content updates
Type: SwitchParameter
Parameter Sets: indexByType
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
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.
INPUTS
OUTPUTS
NOTES
As of 2022-10: Cannot pull data from “/content-updates-inventory” uri with any known id Cannot pull data from the following uris due to insufficient permissions /web/api/v2.1/atlas-agents-control/hotfix-policy/asset-family-types /web/api/v2.1/atlas-agents-control/hotfix-policy/policy