Get-VivaOrgInsightsDelegatedRole
This cmdlet is available only in the Exchange Online PowerShell module v3.7.0-Preview1 or later. For more information, see About the Exchange Online PowerShell module.
Use the Get-VivaOrgInsightsDelegatedRole 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
Get-VivaOrgInsightsDelegatedRole
-Delegator <Guid>
[-ResultSize <Unlimited>]
[<CommonParameters>] Description
Typically, you use this cmdlet with the Remove-VivaOrgInsightsDelegatedRole 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
- Insights Administrator
Important
Microsoft recommends that you use roles with the fewest permissions. Using lower permissioned accounts helps improve security for your organization. Global Administrator is a highly privileged role that should be limited to emergency scenarios when you can't use an existing role.
Examples
Example 1
Get-VivaOrgInsightsDelegatedRole -Delegator 043f6d38-378b-7dcd-7cd8-c1a901881fa9This example filters the results by the specified delegator.
Parameters
-Delegator
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.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
The ResultSize parameter specifies the maximum number of results to return. If you want to return all requests that match the query, use unlimited for the value of this parameter. The default value is 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |