Get-AccessToCustomerDataRequest
This cmdlet is available only in the cloud-based service.
Use the Get-AccessToCustomerDataRequest cmdlet to view Microsoft 365 Customer Lockbox requests that control access to your data by Microsoft support engineers.
Note: Customer Lockbox is included in Microsoft 365 E5, or you can buy a separate Customer Lockbox subscription with any Microsoft 365 Enterprise plan.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
Default (Default)
Get-AccessToCustomerDataRequest
[-ApprovalStatus <String>]
[-CreatedAfter <ExDateTime>]
[-RequestId <String>]
[<CommonParameters>]
Description
You need to be assigned permissions before you can run this cmdlet. Although this article lists all parameters for the cmdlet, you might not have access to some parameters if they aren't included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.
Examples
Example 1
Get-AccessToCustomerDataRequest
This example returns a summary list of all Customer Lockbox request.
Example 2
Get-AccessToCustomerDataRequest -ApprovalStatus Pending
This example returns a summary list of all Customer Lockbox requests that have the status value Pending.
Example 3
Get-AccessToCustomerDataRequest -RequestId EXSR123456 | Format-List
This example returns detailed information the Customer Lockbox request EXSR123456.
Parameters
-ApprovalStatus
Applicable: Exchange Online, Exchange Online Protection
The ApprovalStatus parameter filters the results by approval status. Valid values are:
- Approved
- Canceled
- Denied
- Pending
Parameter properties
| Type: | String |
| 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 |
-CreatedAfter
Applicable: Exchange Online, Exchange Online Protection
The CreatedAfter parameter filters the results by the creation date in Coordinated Universal Time (UTC).
To specify a date/time value for this parameter, use either of the following options:
- Specify the date/time value in UTC: For example, "2021-05-06 14:30:00z".
- Specify the date/time value as a formula that converts the date/time in your local time zone to UTC: For example,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). For more information, see Get-Date.
Parameter properties
| Type: | ExDateTime |
| 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 |
-RequestId
Applicable: Exchange Online, Exchange Online Protection
The RequestId parameter filters the results by reference number (for example, EXSR123456).
Parameter properties
| Type: | String |
| 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.