Skip to content

Set-S1Uninstall

SYNOPSIS

Uninstall SentinelOne agents based on specified filters.

SYNTAX

Set-S1Uninstall [-Filter] <String> [-FilterValue] <Object> [-Groupids] <String[]> [<CommonParameters>]

DESCRIPTION

This function uninstalls SentinelOne agents by specifying a filter, filter values, and group IDs. The uninstall command can also be initiated at the client when there is no console communication.

EXAMPLES

EXAMPLE 1

Set-S1Uninstall -Filter "agentIds" -FilterValue @("agent1", "agent2") -GroupIDs @("group1")

Uninstalls SentinelOne agents with the specified agent IDs in the specified group.

EXAMPLE 2

Set-S1Uninstall -Filter "computerName" -FilterValue "Server01" -GroupIDs @("group1", "group2")

Uninstalls SentinelOne agents with the computer name "Server01" in the specified groups.

EXAMPLE 3

Set-S1Uninstall -Filter "uuid" -FilterValue @("uuid1", "uuid2") -GroupIDs @("group1")

Uninstalls SentinelOne agents with the specified UUIDs in the specified group.

PARAMETERS

-Filter

The filter type to use for selecting agents. Valid values are "agentIds", "computerName", "computerName__contains", "computerName__like", "ids", "uuid", or "uuids".

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilterValue

The value(s) for the specified filter.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Groupids

The group IDs where the uninstall action will be applied. Should be provided as a list (e.g., @('group1', 'group2')).

Type: String[]
Parameter Sets: (All)
Aliases:

Required: True
Position: 3
Default value: None
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