Remove-VivaOrgInsightsDelegatedRole
This cmdlet is available only in the Exchange Online PowerShell module version 3.7.1 or later. For more information, see About the Exchange Online PowerShell module.
Use the Remove-VivaOrgInsightsDelegatedRole cmdlet to remove delegate access from the specified account (the delegate) so they can't view organizational insights like the leader (the delegator).
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
Default (Default)
Remove-VivaOrgInsightsDelegatedRole
-Delegate <Guid>
-Delegator <Guid>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Use the Get-VivaOrgInsightsDelegatedRole cmdlet to find the Microsoft Entra ObjectId values of delegate accounts that were given the capabilities of delegator 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
Remove-VivaOrgInsightsDelegatedRole -Delegate 5eaf7164-f36f-5381-5546-dcaa1792f077 -Delegator 043f6d38-378b-7dcd-7cd8-c1a901881fa9
This example removes the organization insights viewing capability of the specified delegator account from the specified delegate account.
Parameters
-Delegate
Applicable: Exchange Online
The Delegate parameter specifies the account that can view organizational insights like the leader (the account specified by the Delegator account).
A valid value for this parameter is the Microsoft Entra ObjectId value of the delegate 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 |
-Delegator
Applicable: Exchange Online
The Delegator parameter specifies the account of the leader that can view organizational insights. This capability is delegated to the account specified by the Delegate parameter.
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.