Connect-IRT
SYNOPSIS
Connects to Microsoft Graph and Exchange Online for incident response.
SYNTAX
Connect-IRT [-TenantId] <String> [-GCCHigh] [-DeviceCode] [[-AdditionalScope] <String[]>] [-Graph] [-Exchange]
[-IPPS] [[-Browser] <String>] [-Private] [-Force] [-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION
Orchestrates connections to Graph and Exchange Online. When no service switches are specified, both services are connected. Use -Graph or -Exchange to connect to specific services only.
EXAMPLES
EXAMPLE 1
Connect-IRT -TenantId $tid
Connects to Graph and Exchange Online.
EXAMPLE 2
Connect-IRT -TenantId $tid -Graph -DeviceCode
Connects to Graph only using device code auth.
EXAMPLE 3
Connect-IRT -TenantId $tid -Exchange -GCCHigh
Connects to Exchange in a GCC High environment.
PARAMETERS
-TenantId
The TenantId GUID for the environment you want to connect to.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GCCHigh
Connect to a GCC High tenant environment.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeviceCode
Use device code authentication flow instead of interactive browser auth.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-AdditionalScope
Additional Graph scopes to request beyond the default set.
Type: String[]
Parameter Sets: (All)
Aliases: AdditionalScopes
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Graph
Connect to Microsoft Graph only.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Exchange
Connect to Exchange Online only.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-IPPS
{{ Fill IPPS Description }}
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Browser
Browser to use for device code login and URL opening. Valid values: msedge, chrome, firefox, brave, default.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: $Global:IRT_Config.Browser
Accept pipeline input: False
Accept wildcard characters: False
-Private
Open the browser in private/incognito mode.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Force
{{ Fill Force Description }}
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ProgressAction
{{ Fill ProgressAction Description }}
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
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
OUTPUTS
NOTES
Version: 1.0.0