Skip to content

Latest commit

 

History

History
114 lines (81 loc) · 3.28 KB

File metadata and controls

114 lines (81 loc) · 3.28 KB
external help file Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
Module Name Microsoft.Online.SharePoint.PowerShell
online version https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/approve-spotenantserviceprincipalpermissionrequest
applicable SharePoint Online
title Approve-SPOTenantServicePrincipalPermissionRequest
schema 2.0.0
author samkabue
ms.author speedta
ms.reviewer

Approve-SPOTenantServicePrincipalPermissionRequest

SYNOPSIS

Approves a permission request for the current tenant's "SharePoint Online Client" service principal

SYNTAX

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

-RequestId

The ID of the permission request to approve

Type: System.Guid
Parameter Sets: (All)
Aliases:

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

None

OUTPUTS

System.Object

NOTES

RELATED LINKS