Approve-SPOTenantServicePrincipalPermissionRequest
Approves a permission request for the current tenant's "SharePoint Online Client" service principal
Syntax
Default (Default)
Approve-SPOTenantServicePrincipalPermissionRequest
-RequestId <Guid>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Approves a permission request for the current tenant's "SharePoint Online Client" service principal
The return value of a successful call is a permission grant object. See the Description section of Get-SPOTenantServicePrincipalPermissionGrants for more information about a permission grant object.
To get the collection of permission grants for the "SharePoint Online Client" service principal, use the Get-SPOTenantServicePrincipalPermissionGrants command.
Approving a permission request also removes that request from the list of permission requests.
Examples
EXAMPLE 1
$requests = Get-SPOTenantServicePrincipalPermissionRequests
$requestToApprove = $requests | ? { $_.Resource -eq 'Office 365 SharePoint Online' -and $_.Scope -eq 'MyFiles.Read' } | Select-Object -First 1
if ($requestToApprove -ne $null)
{
Approve-SPOTenantServicePrincipalPermissionRequest -RequestId $requestToApprove.Id
}
Approves the permission request for the 'Office 365 SharePoint Online' resource with scope claim 'MyFiles.Read'. If there is no request with those properties, then no approve action will be taken.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RequestId
The ID of the permission request to approve
Parameter properties
| Type: | System.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 |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
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.