Skip to content

Commit 29b4965

Browse files
authored
Merge branch 'master' into patch-362
2 parents 8ec8494 + b18275e commit 29b4965

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

exchange/exchange-ps/exchange/New-ApplicationAccessPolicy.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.reviewer:
1414
## SYNOPSIS
1515
This cmdlet is available only in the cloud-based service.
1616

17-
Use the New-ApplicationAccessPolicy cmdlet to restrict or deny access for an application that is using Outlook REST APIs or Microsoft Graph APIs to a specific set of mailboxes. These policies are complementary to the permission scopes that are declared by the application.
17+
Use the New-ApplicationAccessPolicy cmdlet to restrict or deny access to a specific set of mailboxes by an application that uses APIs (Outlook REST, Microsoft Graph, or Exchange Web Services (EWS)). These policies are complementary to the permission scopes that are declared by the application.
1818

1919
**Note**: We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see [Connect to Exchange Online PowerShell](https://docs.microsoft.com/powershell/exchange/connect-to-exchange-online-powershell).
2020

@@ -33,9 +33,9 @@ New-ApplicationAccessPolicy -AccessRight <ApplicationAccessPolicyRight> -AppId <
3333
## DESCRIPTION
3434
You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not 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](https://docs.microsoft.com/powershell/exchange/find-exchange-cmdlet-permissions).
3535

36-
A limit of 100 policies per Microsoft 365 tenant is enforced as of today. An error message stating "A tenant cannot have more than 100 policies." will be displayed if this number is exceeded.
36+
You can create a limited number of policies in your organization based on a fixed amount of space. If your oganization runs out of space for these policies, you'll see the error: "The total size of App Access Policies exceeded the limit." To maximize the number of policies and reduce the amount of space that's consumed by the policies, set a one space charachter description for the policy. This method will allow aproximately 300 policies (versus a previous limit of 100 policies).
3737

38-
While the scope-based resource access like Mail.Read or Calendar.Read is effective to ensure that the application can only read mails or events within a mailbox and not do anything else; Application Access Policy feature allows admins to enforce limits that are based on a list of mailboxes. For example, in a global organization apps developed for one country shouldn't have access to data from other countries or a CRM integration application should only access calendar of the Sales organization and no other departments.
38+
While scope-based resource access like Mail.Read or Calendar.Read is effective to ensure that the application can only read email or events within a mailbox and not do anything else, application access policies allow admins to enforce limits that are based on a list of mailboxes. For example, apps developed for one country shouldn't have access to data from other countries. Or, or a CRM integration application should only access calendars in the Sales organization and no other departments.
3939

4040
Every API request using the Outlook REST APIs or Microsoft Graph APIs to a target mailbox done by an application is verified using the following rules (in the same order):
4141

@@ -61,15 +61,15 @@ This example creates a new application access policy with the following settings
6161

6262
### Example 2
6363
```powershell
64-
New-ApplicationAccessPolicy -AccessRight RestrictAccess -AppId "e7e4dbfc-046f-4074-9b3b-2ae8f144f59b" -PolicyScopeGroupId [email protected] -Description "Restrict this app to members of security group EvenUsers."
64+
New-ApplicationAccessPolicy -AccessRight RestrictAccess -AppId "e7e4dbfc-046f-4074-9b3b-2ae8f144f59b" -PolicyScopeGroupId [email protected] -Description "Restrict this app's access to members of security group EvenUsers."
6565
```
6666

6767
This example creates a new application access policy with the following settings:
6868

6969
- AccessRight: RestrictAccess
7070
- AppIDs: e7e4dbfc-046f-4074-9b3b-2ae8f144f59b
7171
- PolicyScopeGroupId: [email protected]
72-
- Description: Restrict this app to members of security group EvenUsers.
72+
- Description: Restrict this app's access to members of security group EvenUsers.
7373

7474
### Example 3
7575
```powershell
@@ -86,10 +86,10 @@ This example creates a new application access policy with the following settings
8686
## PARAMETERS
8787

8888
### -AccessRight
89-
The AccessRight parameter specifies the permission that you want to assign in the application access policy. Valid values are:
89+
The AccessRight parameter specifies the restriction type that you want to assign in the application access policy. Valid values are:
9090

91-
- RestrictAccess
92-
- DenyAccess
91+
- RestrictAccess: Allows the associated app to only access data that's associated with mailboxes specified by the PolicyScopeGroupID parameter.
92+
- DenyAccess: Allows the associated app to only access data that's not associated with mailboxes specified by the PolicyScopeGroupID parameter.
9393

9494
```yaml
9595
Type: ApplicationAccessPolicyIdParameter

0 commit comments

Comments
 (0)