Skip to content

Commit e2d8c34

Browse files
authored
CTA article addition (SharePoint#9628)
* CTA article addition * CTA article addition 2 * edits to the spe admin role * numbering * fix comment
1 parent 459f7e2 commit e2d8c34

File tree

5 files changed

+35
-42
lines changed

5 files changed

+35
-42
lines changed

docs/embedded/concepts/admin-exp/billing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ To enable PAYG on SharePoint Embedded, you need:
2424
## Roles and Permissions
2525

2626
- Admin who will set up billing relationship for SharePoint Embedded will need to have owner or contributor permissions on Azure subscription.
27-
- Admin will need to have a SharePoint administrator role to operate billing cmdlets.
27+
- Admin will need to have a SharePoint Embedded Administrator role to operate billing cmdlets.
2828

2929
## Steps to establish billing
3030

docs/embedded/concepts/admin-exp/cta.md

Lines changed: 10 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,18 @@ ms.localizationpriority: high
77

88
# Consuming Tenant Admin
99

10-
The organizations that use the SharePoint Embedded applications on their Microsoft 365 tenants are the consuming tenants and the persona that is responsible for managing these applications on their Microsoft 365 tenancy is the consuming tenant administrator. Consuming tenant administrators can perform various administrative actions on the SharePoint Embedded applications registered on their Microsoft 365 tenant and on the Containers that hold the content. They can also manage tenant level configurations and ensure that data is stored in a secure, protected way that meets customers’ business and compliance policies. In this article, we describe the enterprise manageability features that are supported and available to the consuming tenant administrator.
10+
> [!IMPORTANT]
11+
> Assign the SharePoint Embedded Administrator role available in M365 Admin Center or Microsoft Entra to execute SharePoint Embedded Container commandlets mentioned in this article.
12+
>
13+
> Global Administrators can continue to execute SharePoint Embedded container cmdlets.
14+
>
15+
> If you are a SharePoint Administrator, grant yourself the SharePoint Embedded Admin role as well to execute these cmdlets.
16+
17+
The organizations that use the SharePoint Embedded applications on their Microsoft 365(Microsoft 365) tenants are the consuming tenants and the persona that is responsible for managing these applications on their Microsoft 365 tenancy is the consuming tenant administrator. Consuming tenant administrators can perform various administrative actions on the SharePoint Embedded applications registered on their Microsoft 365 tenant and on the Containers that hold the content. They can also manage tenant level configurations and ensure that data is stored in a secure, protected way that meets customers’ business and compliance policies. In this article, we describe the enterprise manageability features that are supported and can be performed by the consuming tenant administrator.
1118

1219
## 1. Consuming Tenant Admin Role
1320

14-
Microsoft 365 SharePoint Administrator serves as the consuming tenant admin. Global Administrators in Microsoft 365 can assign users the SharePoint Administrator. The Global Administrator role already has all the permissions of the SharePoint Administrator role. For information about assigning a user the SharePoint Administrator role, see [Assign admin roles in the Microsoft 365 admin center](/microsoft-365/admin/add-users/assign-admin-roles).
21+
Microsoft 365 SharePoint Embedded Administrator serves as the consuming tenant admin. Global Administrators in Microsoft 365 can assign users the SharePoint Embedded Administrator. The Global Administrator role already has all the permissions of the SharePoint Embedded Administrator role. A SharePoint Administrator can assign themselves the SharePoint Embedded Administrator role to act as a Consuming Tenant Admin for SharePoint Embedded. The SharePoint Embedded Role is available in Microsoft Entra and M365 Admin Center.
1522

1623
## 2. Administration Tools
1724

@@ -113,39 +120,7 @@ Admins can permanently delete a Container from the deleted container collection
113120
Remove-SPODeletedContainer -Identity <ContainerId>
114121
```
115122

116-
## 5. Tenant Administration
117-
118-
SharePoint Online enables admins to manage various tenant-wide settings with the [Set-SPOTenant](/powershell/module/sharepoint-online/set-spotenant) PowerShell command. This command allows administrators to modify global settings that affect the behavior and functionality of SharePoint Online for all users in the organization.
119-
120-
These tenant-wide settings are also applicable to all SharePoint Embedded applications on the tenant. These settings include conditional access policies, BlockDownloadFileTypePolicy, and SharingCapability to name a few. Learn more about the Set-SPOTenant settings here: [Set-SPOTenant](/powershell/module/sharepoint-online/set-spotenant).
121-
122-
### Unique External Sharing settings for SharePoint Embedded
123-
124-
Admins can configure external sharing settings ONLY for SharePoint Embedded applications at the tenant level with the following commands. The external sharing features let users in your organization share content with people outside the organization (such as partners, vendors, clients, or customers), ensuring sensitive data isn't accidentally shared with unauthorized users.
125-
126-
```powershell
127-
Set-SPOTenant -ContainerSharingCapability <ContainerSharingCapabilities>
128-
```
129-
130-
> [!NOTE]
131-
>
132-
> - External sharing for SharePoint Embedded defaults to the tenant setting set with `Set-SPOTenant [-SharingCapability <SharingCapabilities>]`.
133-
> - External sharing settings for SharePoint Embedded must be equally or more restrictive than the tenant-wide external sharing settings.
134-
135-
Other unique sharing settings for SharePoint Embedded applications include:
136-
137-
```powershell
138-
Set-SPOTenant -ContainerDefaultShareLinkScope
139-
```
140-
141-
```powershell
142-
Set-SPOTenant -ContainerDefaultShareLinkRole
143-
```
144-
145-
```powershell
146-
Set-SPOTenant -ContainerDefaultLinkToExistingAccess
147-
```
148123

149-
## 6. Security and Compliance Administration
124+
## 5. Security and Compliance Administration
150125

151126
SharePoint Embedded uses Microsoft’s comprehensive compliance and data governance solutions to help organizations manage risks, protect, and govern sensitive data, and respond to regulatory requirements. Security and compliance solutions work in a similar manner in the SharePoint Embedded platform as they do today in Microsoft 365 platform so that data is stored in a secure, protected way that meets customers’ business and compliance policies while making it easy for Compliance and SharePoint Administrators to enforce critical security and compliance policies on the content. For information on supported security and compliance capabilities, see [Security and Compliance](../security-and-compliance.md).

docs/embedded/concepts/admin-exp/dev-admin.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Organizations that create file management applications with the help of SharePoi
1212

1313
## Developer Admin Role
1414

15-
A Microsoft 365 SharePoint Administrator serves as the developer admin. Global Administrators in Microsoft 365 can assign users the SharePoint Administrator role. The Global Administrator role already has all the permissions of the SharePoint Administrator role. For information about assigning a user the SharePoint administrator role, see Assign admin roles in the Microsoft 365 admin center.
15+
A Microsoft 365 SharePoint Embedded Administrator serves as the developer admin. Global Administrators in Microsoft 365 can assign users the SharePoint Embedded Administrator role. The Global Administrator role already has all the permissions of the SharePoint Embedded Administrator role. For information about assigning a user the SharePoint Embedded Administrator role, see Assign admin roles in the Microsoft 365 admin center.
1616

1717
### Billing responsibilities of Developer admin
1818

@@ -27,6 +27,12 @@ To get started using PowerShell to manage SharePoint Embedded, you have to insta
2727
> [!IMPORTANT]
2828
> You need version 16.0.24211.12000 or higher to run the commands for SharePoint Embedded.
2929
30+
> [!IMPORTANT]
31+
> Assign the SharePoint Embedded Administrator role available in M365 Admin Center or Microsoft Entra to execute SharePoint Embedded Container commandlets mentioned in this article.
32+
>
33+
> Global Administrators can continue to execute SharePoint Embedded container cmdlets.
34+
>
35+
> If you are a SharePoint Administrator, grant yourself the SharePoint Embedded Admin role as well to execute these cmdlets.
3036
## PowerShell cmdlets for admin experience
3137

3238
### Creation of container types
@@ -78,8 +84,8 @@ For more information about billing, see [Billing](./billing.md).
7884

7985
## Roles and Permissions
8086

81-
The user or admin who will set up billing relationship for SharePoint Embedded will need to have owner or contributor permissions on Azure subscription.
87+
The user or admin who will set up billing relationship for SharePoint Embedded will need to have owner or contributor permissions on a Azure subscription.
8288

8389
If you don't have an Azure subscription, follow steps here to [create a subscription](/azure/cloud-adoption-framework/ready/azure-best-practices/initial-subscriptions)
8490

85-
The user or admin will need to have a SharePoint administrator role to operate SPO PowerShell cmdlets.
91+

docs/embedded/concepts/app-concepts/containertypes.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,12 +16,14 @@ There are two kinds of Container Types that a developer tenant can create:
1616
1. [Trial Container Types](#trial-container-types)
1717
1. [Standard Container Types](#standard-container-types)
1818

19+
20+
1921
## Trial Container Types
2022

2123
To enable customers to explore the development of SharePoint Embedded applications and assess its features, we offer the ability to create a Trial Container Type. Each customer can have only one Trial Container Type in their tenant at a time. The tenant developing the application can utilize Trial Container Types, which aren't linked to a billing profile. In this scenario, the partner tenant remains the same as the consuming tenant. The Trial Container Type remains valid for up to 30 days but can be removed at any time within this period. There are two ways to create a Trial Container Type:
2224

2325
- You can use [SharePoint Embedded Visual Studio Code Extension](../../getting-started/spembedded-for-vscode.md) to create a Trial Container Type in just a few steps. The Visual Studio Code extension also registers your Container Type and creates Containers for you.
24-
- A Trial Container Type can be created using SharePoint PowerShell. You must be a SharePoint Administrator or Global Administrator to run this cmdlet.
26+
- A Trial Container Type can be created using SharePoint PowerShell. You must be a SharePoint Embedded Administrator or Global Administrator to run this cmdlet. If you are a SharePoint Administrator, grant yourself the SharePoint Embedded Admin role as well to execute these cmdlets.
2527

2628
```powershell
2729
New-SPOContainerType
@@ -46,7 +48,17 @@ Standard Container Types are associated with a billing profile in [Azure portal]
4648

4749
A developer admin can create a new billable Container Type using the following PowerShell cmdlet. Tenants can create a maximum of five Container Types. Trial Container Types don't count against the maximum number of Container Types that a Partner tenant can create.
4850

49-
You must be a SharePoint Administrator or Global Administrator to run this cmdlet and must have the latest version of SharePoint PowerShell module.
51+
52+
> [!IMPORTANT]
53+
> Assign the SharePoint Embedded Administrator role available in M365 Admin Center or Microsoft Entra to execute SharePoint Embedded Container commandlets mentioned in this article.
54+
>
55+
> Global Administrators can continue to execute SharePoint Embedded container cmdlets.
56+
>
57+
> If you are a SharePoint Administrator, grant yourself the SharePoint Embedded Admin role as well to execute these cmdlets.
58+
59+
60+
> [!NOTE]
61+
> The user or admin who will set up billing relationship for SharePoint Embedded will need to have owner or contributor permissions on the Azure subscription.
5062
5163
```powershell
5264
New-SPOContainerType

docs/embedded/concepts/security-and-compliance.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ Policy tips are shown today for files hosted in SharePoint Online so that users
9797
Global Administrators and SharePoint Administrators can set and remove sensitivity labels on a SharePoint Embedded Container by using the newly created SharePoint PowerShell cmdlet:
9898
9999
```powershell
100-
Set -SPOContainer -Identity <ContainerID/ContainerSiteURL> -SensitivityLabel <SensitivityLabelGUID>
100+
Set-SPOContainer -Identity <ContainerID/ContainerSiteURL> -SensitivityLabel <SensitivityLabelGUID>
101101
```
102102

103103
To learn more about setting sensitivity labels, see [Learn about sensitivity labels](/purview/sensitivity-labels).

0 commit comments

Comments
 (0)