Skip to main content
Version: Insiders

Get-EasyTeam

SYNOPSIS​

Get EasyLife Teams from the Graph API.

SYNTAX​

byDisplayName (Default)​

Get-EasyTeam [-DisplayName <String>] [-Top <Int32>] [-PropertySet <Object>] [<CommonParameters>]

byId​

Get-EasyTeam [-Id <String>] [-PropertySet <Object>] [<CommonParameters>]

all​

Get-EasyTeam [-Top <Int32>] [-All] [-PropertySet <Object>] [<CommonParameters>]

DESCRIPTION​

This function uses Get-MgGroup and Get-MgTeam to retrieve Teams from the Graph API. It expands properties relevant to EasyLife such as policy states and metadata.

EXAMPLES​

EXAMPLE 1​

Get-EasyTeam

This example returns up to 100 Teams and their properties.

EXAMPLE 2​

Get-EasyTeam -All

This example returns all Teams and their properties.

EXAMPLE 3​

Get-EasyTeam -Top 3

This example returns 3 Teams and their properties.

EXAMPLE 4​

Get-EasyTeam -DisplayName Project

This example returns all Teams that have a DisplayName that starts with Project.

EXAMPLE 5​

Get-EasyTeam -All -PropertySet Minimum

This example returns all Teams with a minimum set of attributes that can be retrieved quickly. The resulting objects will not have the Owners and WebUrl properties populated.

PARAMETERS​

-Id​

Use this parameter to retrieve a teams with the specified Id.

Type: String
Parameter Sets: byId
Aliases:

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

-DisplayName​

Use this parameter to retrieve teams that have a DisplayName that starts with the given value.

Type: String
Parameter Sets: byDisplayName
Aliases:

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

-Top​

Use this parameter to retrieve the specified number of teams.

Type: Int32
Parameter Sets: byDisplayName, all
Aliases:

Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-All​

Use this parameter to retrieve all unified teams.

Type: SwitchParameter
Parameter Sets: all
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-PropertySet​

Use this parameter to select a set of attributes to be retrieved from the Graph API. This can be useful for automation or when dealing with a large number of objects. Currently, the only available set is Minimum.

Type: Object
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
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​

None​

You cannot pipe values to this cmdlet.​

OUTPUTS​

[ELTeam]​

This function returns object of the type ELTeam.​

NOTES​

This function makes two requests to the Graph API for each Team, hence it is slower than Get-EasyGroup.

https://docs.easylife365.cloud/docs/add-ons/powershell/get-easyTeam/