Get-WorkforceInsightsDelegationAccess
This cmdlet is available only in the Exchange Online PowerShell module version 3.9.2-Preview1 or later. For more information, see About the Exchange Online PowerShell module.
Use the Get-WorkforceInsightsDelegationAccess cmdlet to view all delegates of the specified delegator. Delegate accounts can view organizational insights like the specified delegator.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
Default (Default)
Get-WorkforceInsightsDelegationAccess
-Delegator <Guid>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Typically, you use this cmdlet with the Remove-WorkforceInsightsDelegationAccess cmdlet to find the Microsoft Entra ObjectId values of the delegate accounts.
To run this cmdlet, you need to be a member of one of the following role groups in Microsoft Entra ID in the destination organization:
- Global Administrator
- AI Administrator
Important
Microsoft strongly advocates for the principle of least privilege. Assigning accounts only the minimum permissions necessary to perform their tasks helps reduce security risks and strengthens your organization's overall protection. Global Administrator is a highly privileged role that you typically limit to emergency scenarios or when you can't use a different role.
Examples
Example 1
Get-WorkforceInsightsDelegationAccess -Delegator a5f5dbca-8cc8-4a36-bbfc-9b8947b4eb60
This example filters the results by the specified delegator.
Parameters
-Delegator
Applicable: Exchange Online
The Delegator parameter specifies the account of the leader that can view organizational insights. This capability is given to delegates.
A valid value for this parameter is the ObjectID value of the delegator account. Use the Get-MgUser cmdlet in Microsoft Graph PowerShell to find this value.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ResultSize
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | Unlimited |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.