Connect-IRTIPPS

SYNOPSIS

Connects to Security & Compliance PowerShell (IPPS).

SYNTAX

Connect-IRTIPPS [-TenantId] <String> [[-UserPrincipalName] <String>] [-GCCHigh] [-DeviceCode]
 [[-AccessToken] <String>] [[-SearchOnly] <Boolean>] [[-Browser] <String>] [-Private] [-Force]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Acquires a portable access token via MSAL using EXO's first-party client ID and the IPPS audience, then passes it to Connect-IPPSSession via -AccessToken. This bypasses IPPS's internal MSAL token-acquisition path, which fails with an assembly version mismatch when the Microsoft.Graph.Authentication MSAL has been pre-loaded.

EXAMPLES

Example 1

PS C:\> {{ Add example code here }}

{{ Add example description here }}

PARAMETERS

-TenantId

{{ Fill TenantId Description }}

Type: String
Parameter Sets: (All)
Aliases:

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

-UserPrincipalName

{{ Fill UserPrincipalName Description }}

Type: String
Parameter Sets: (All)
Aliases:

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

-GCCHigh

{{ Fill GCCHigh Description }}

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DeviceCode

{{ Fill DeviceCode Description }}

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-AccessToken

{{ Fill AccessToken Description }}

Type: String
Parameter Sets: (All)
Aliases:

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

-SearchOnly

Use the search-only audience (https://dataservice.o365filtering.com) and pass -EnableSearchOnlySession to Connect-IPPSSession. Required for newer eDiscovery and retention cmdlets (New-ComplianceSearchAction, Set-RetentionCompliancePolicy, etc.). Defaults to $true.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Browser

{{ Fill Browser Description }}

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
Default value: $Global:IRT_Config.Browser
Accept pipeline input: False
Accept wildcard characters: False

-Private

{{ Fill Private Description }}

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: 2.0.0

RELATED LINKS