address comments on Get-SPOApplication and Set-SPOApplicationPermission

Author: cindylay

sharepoint/sharepoint-ps/sharepoint-online/Get-SPOApplication.md

@@ -32,7 +32,7 @@ Get-SPOApplication [[-OwningApplicationId] <OwningApplicationid>] [[-Application
 
 ## DESCRIPTION
 
-The `Get-SPOApplication` cmdlet retrieves and returns all third-party SharePoint Embedded applications registered in a tenant that match the given criteria. You must be a SharePoint Online Administrator or Global Administrator to run the cmdlet. For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). 
+The `Get-SPOApplication` cmdlet retrieves and returns SharePoint Embedded applications of all publishers registered in a tenant that match the given criteria. You must be a SharePoint Online Administrator or Global Administrator to run the cmdlet. For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). 
 
 ## EXAMPLES
 
@@ -50,19 +50,16 @@ Example 1 returns all SharePoint Embedded applications registered in the specifi
 Get-SPOApplication -OwningApplicationId <OwningApplicationId>
 ```
 
-Example 2 lists the details of the owning application corresponding to the `OwningApplicationId` registered in the specified tenant.
+Example 2 lists the details of the owning application corresponding to the `OwningApplicationId` registered in the specified tenant. This returns `Applications` which specifies the list of guest applications IDs with current access permissions to the owning application, `SharingCapability` settings, and `OverrideTenantSharingCapability` status.
 
-TODO: add portion about viewing active 1P app Ids in this cmdlet
 
 ### Example 3
 
 ```powershell
 Get-SPOApplication -OwningApplicationId <OwningApplicationId> -ApplicationId <ApplicationId>
 ```
 
-Example 3 enumerates permissions of the owning applications registered in the specified tenant.
-
-TODO: Add portion about viewing guest app permissions in this cmdlet (1P guest app perms)
+Example 3 list details of the guest application specified in `ApplicationId`. This inclues the list of guest application access permissions. Note that only app-only permissions are supported.
 
 ## PARAMETERS
 
@@ -76,9 +73,11 @@ The following details are returned:
 
 - OwningApplicationName
 
-- Storage
-
 - Applications (by id)
+
+- SharingCapability
+
+- OverrideTenantSharingCapability
 
 ```yaml
 Type: String
@@ -95,7 +94,7 @@ Accept wildcard characters: False
 
 ### -ApplicationId
 
-Use this parameter to enumerate permissions of the owning applications registered in the specified tenant.
+Use this parameter to enumerate app-only permissions of the guest application id with access to the specified owning application.
 
 ```yaml
 Type: String
@@ -118,4 +117,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 ## RELATED LINKS
 
 [Get-SPOContainer](./Get-SPOContainer.md)
-[Set-SPOApplication] (Set-SPOApplication.md)
+[Set-SPOApplication](./Set-SPOApplication.md)

sharepoint/sharepoint-ps/sharepoint-online/Set-SPOApplicationPermission.md

@@ -14,7 +14,7 @@ ms.reviewer:
 
 ## SYNOPSIS
 
-Adds permissions for a guest application to access a SharePoint Embedded application.
+Manages permissions for a guest application to access a SharePoint Embedded application.
 
 ## SYNTAX
 
@@ -31,37 +31,36 @@ Set-SPOApplicationPermission
 
 ## DESCRIPTION
 
-The `Set-SPOApplicationPermission` cmdlet adds a guest app permission to a SharePoint Embedded application. Currently only app-only permissions are supported at this time. Delegated permissions are not support for guest applications. A guest application is defined as any application within the enterprise applications of the owning tenant. 
+The `Set-SPOApplicationPermission` cmdlet manages permissions for a guest app's access to a SharePoint Embedded application. This includes adding, updating, and deleting guest app permissions. Currently only app-only permissions are supported at this time. Delegated permissions are not supported for guest applications. A guest application is defined as any application within the enterprise applications of the owning tenant. 
 
-You must be a SharePoint Online Administrator or Global Administrator to run this cmdlet. For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). 
+You must be a SharePoint Online Administrator to run this cmdlet. For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). 
 
 ## EXAMPLES
 
 ### Example 1
 
 ```powershell
-Set-SPOApplicationPermission
--OwningApplicationId a187e399-0c36-4b98-8f04-1edc167a0996 
--ApplicationId 12345678-1234-1234-abcd-abcdefghijkl
--PermissionAppOnly Read, Write, Delete
+Set-SPOApplicationPermission -OwningApplicationId a187e399-0c36-4b98-8f04-1edc167a0996 -ApplicationId 12345678-1234-1234-abcd-abcdefghijkl -PermissionAppOnly Read
 ```
 
 
-Example 1 gives the Guest App with ID `12345678-1234-1234-abcd-abcdefghijkl` app-only Read, Write, and Delete permissions to access the Owning Application Microsoft Loop of ID `a187e399-0c36-4b98-8f04-1edc167a0996`.
+Example 1 gives the guest app with ID `12345678-1234-1234-abcd-abcdefghijkl` app-only Read permissions to access the owning application Microsoft Loop of ID `a187e399-0c36-4b98-8f04-1edc167a0996`.
 
 ### Example 2
 
 ```powershell
-Set-SPOApplicationPermission
--OwningApplicationId 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 
--ApplicationId 12345678-1234-1234-abcd-abcdefghijkl>
--PermissionAppOnly ReadContent, WriteContent
--PermissionDelegated None
+Set-SPOApplicationPermission -OwningApplicationId 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 -ApplicationId 12345678-1234-1234-abcd-abcdefghijkl -PermissionAppOnly ReadContent -PermissionDelegated None
 ```
 
-Example 2 gives the Guest App with ID `12345678-1234-1234-abcd-abcdefghijkl` app-only Read, Write, and Delete permissions to access the Owning Application Microsoft Designer of ID `a187e399-0c36-4b98-8f04-1edc167a0996`. Notice that delegated permissions are not supported at this time and are default set to `None`.
+Example 2 gives the guest app with ID `12345678-1234-1234-abcd-abcdefghijkl` app-only ReadContent permissions to access the owning application Microsoft Designer of ID `a187e399-0c36-4b98-8f04-1edc167a0996`. Notice that delegated permissions are not supported at this time and are default set to `None`.
 
+### Example 3
 
+```powershell
+Set-SPOApplicationPermission -OwningApplicationId 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 -ApplicationId 12345678-1234-1234-abcd-abcdefghijkl -PermissionAppOnly None -PermissionDelegated None
+```
+
+Example 3 sets guest application permissions to None for the guest app with ID `12345678-1234-1234-abcd-abcdefghijkl`. This has deleted previous permissions for that guest app to access owning application of `a187e399-0c36-4b98-8f04-1edc167a0996`. Notice that delegated permissions are not supported at this time and are default set to `None`.
 
 ## PARAMETERS