Skip to main content
Version: Insiders

Connect-EasyLife365

SYNOPSIS​

Connect to EasyLife 365.

SYNTAX​

byClientIdAndScope (Default)​

Connect-EasyLife365 [-ClientId <String>] [-Scopes <String[]>] [<CommonParameters>]

byIdentity​

Connect-EasyLife365 [-Identity] [<CommonParameters>]

DESCRIPTION​

This function uses the Microsoft.Graph.Authentication module to connect to the Graph API with the scopes: User.ReadWrite.All, Group.ReadWrite.All.

EXAMPLES​

EXAMPLE 1​

Connect-EasyLife365

This example connects to the Graph API using the scopes User.ReadWrite.All, Group.ReadWrite.All, Team.ReadBasic.All.

EXAMPLE 2​

Connect-EasyLife365 -Scopes 'User.Read.All', 'Group.Read.All', 'Team.ReadBasic.All'

This example connects to the Graph API using the scopes User.Read.All, Group.Read.All, Team.ReadBasic.All.

EXAMPLE 3​

Connect-EasyLife365 -ClientId '00df8f0a-c19b-4c56-83dc-c1aaf622fe64' -Scopes 'User.Read.All', 'Group.Read.All', 'Team.ReadBasic.All'

This example connects to the Graph API using the AAD application with ID '00df8f0a-c19b-4c56-83dc-c1aaf622fe64' and the scopes User.Read.All, Group.Read.All, Team.ReadBasic.All.

EXAMPLE 4​

Connect-EasyLife365 -Identity

This example connects to the Graph API using a managed identity. This can be used in Azure Automation Accounts or Azure Function Apps.

Please note that the required permissions must be granted to the managed identity's service principal before.

You can use Grant-EasyAppPermissions to grant the required permissions to your service principal.

EXAMPLE 5​

Connect-MgGraph -Scopes User.ReadWrite.All, Group.ReadWrite.All, Team.ReadBasic.All

This example uses Connect-MgGraph to connect to the Graph API. You can use existing Graph contexts as long as they contain the required scopes.

PARAMETERS​

-Identity​

Use this parameter to connect with a managed identity in Azure Automation or Azure Function Apps.

Type: SwitchParameter
Parameter Sets: byIdentity
Aliases:

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

-ClientId​

Use this parameter to specify a ClientId when connecting to the Graph API.

Type: String
Parameter Sets: byClientIdAndScope
Aliases:

Required: False
Position: Named
Default value: 14b899c6-0b3a-4f59-8807-e9df5fb0fb1e
Accept pipeline input: False
Accept wildcard characters: False

-Scopes​

Use this parameter to specify the scopes when connecting to the Graph API.

Type: String[]
Parameter Sets: byClientIdAndScope
Aliases:

Required: False
Position: Named
Default value: @('User.ReadWrite.All', 'Group.ReadWrite.All', 'Team.ReadBasic.All')
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​

None. This function does not write object to the pipeline. It writes an informational message to the Information output stream.

NOTES​

Currently, this fuction only connects to the Graph API. Connection to the EasyLife API is not yet available. You need to have permissions to consent the use of Microsoft Graph PowerShell in your Entra ID.

https://docs.easylife365.cloud/docs/add-ons/powershell/connect-easylife365/