Get-DSecurityGroup

NAME Get-DSecurityGroup



SYNOPSIS

Gets one or multiple security groups from Delegate365.





SYNTAX

Get-DSecurityGroup [-All <SwitchParameter>] [-Identity <string>] [-OU <string>] [-UnAssigned <SwitchParameter>]

[<CommonParameters>]





DESCRIPTION

Get-DSecurityGroup returns a list of security groups from Delegate365. Security groups (SG) are an essential part

in organizing users and can be used to automate OU and license assignments in Delegate365. Parameters allow to get

all security groups or one specific security group. Filter for one security group by using the -Identity Parameter

and the full name or the ID. The output shows the most essential properties for each security group.





PARAMETERS

-UnAssigned <SwitchParameter>

Delivers all security groups that are not assigned to an OU.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-All <SwitchParameter>

Delivers all security groups (and not only the first 100 items).



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Identity <string>

Filter for one specific security group. Wildcards are not supported, use the full name or the ID.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-OU <string>

Filter by the name of an OU.



Required? false

Position? named

Default value

Accept pipeline input? false

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



OUTPUTS

Delegate365.Api.Core.Models.SecurityGroup[]





---------- EXAMPLE 1 ----------



Get-DSecurityGroup



By default, the command returns the first 100 assigned security groups.

---------- EXAMPLE 2 ----------



Get-DSecurityGroup -All



Add -All to get all security groups.

---------- EXAMPLE 3 ----------



Get-DSecurityGroup -Unassigned -All



Add -Unassigned to get security groups that are NOT assigned to an OU (can be combined with -All).

---------- EXAMPLE 4 ----------



Get-DSecurityGroup -OU Seattle



Add -OU to get security groups that are assigned to a specific OU.

---------- EXAMPLE 5 ----------



Get-DSecurityGroup -Identity 'Sales department'



Get one specific security group by name or by ID.



RELATED LINKS

Delegate365 support https://support.delegate365.com/