Skip to content

Commit ac87d30

Browse files
Merge branch 'main' into patch-2
2 parents 66b45e5 + 33954aa commit ac87d30

File tree

4 files changed

+341
-1
lines changed

4 files changed

+341
-1
lines changed
Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
---
2+
external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
3+
Module Name: Microsoft.Online.SharePoint.PowerShell
4+
online version: https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/get-sporestrictedsitecreationforapps
5+
applicable: SharePoint Online
6+
title: Get-SPORestrictedSiteCreationForApps
7+
schema: 2.0.0
8+
author: vgaddam-pm
9+
ms.author: vgaddam
10+
ms.reviewer:
11+
---
12+
13+
# Get-SPORestrictedSiteCreationForApps
14+
15+
## SYNOPSIS
16+
17+
This cmdlet allows SharePoint Administrators to check the current configuration of the restricted site creation for apps feature.
18+
19+
## SYNTAX
20+
21+
```
22+
Get-SPORestrictedSiteCreationForApps [-SiteType <RestrictedSiteCreationSiteType>] [<CommonParameters>]
23+
```
24+
25+
## DESCRIPTION
26+
27+
This cmdlet obtains the current configuration information for the restricted site creation for apps feature, including whether it is enabled, the current mode, and the current policies.
28+
29+
> [!Note]
30+
> This feature is currently in preview and may not be available in your tenant.
31+
32+
## EXAMPLES
33+
34+
### Example 1
35+
36+
```powershell
37+
Get-SPORestrictedSiteCreationForApps
38+
```
39+
40+
Example 1 returns all configuration information for the restricted site creation for apps feature. This includes whether the feature is enabled, the current mode (deny or allow), and the app IDs configured for each site type.
41+
42+
### Example 2
43+
44+
```powershell
45+
Get-SPORestrictedSiteCreation –SiteType Communication
46+
```
47+
48+
Example 2 returns a comma-separated list of the app IDs for the `Communication` site type. Depending on whether restricted site creation is in allow or deny mode, these apps are either allowed or denied from creating SharePoint communication sites.
49+
50+
## PARAMETERS
51+
52+
### -SiteType
53+
54+
> Applicable: SharePoint Online
55+
When provided, only return the Microsoft Entra security groups configured for the specified site type.
56+
57+
PARAMVALUE: All | SharePoint | OneDrive | Team | Communication
58+
- All - OneDrive and all SharePoint sites
59+
- SharePoint - All SharePoint sites (but not OneDrive)
60+
- OneDrive - Only OneDrive
61+
- Team - Only SharePoint team sites (group-connected and classic)
62+
- Communication - Only SharePoint communication sites
63+
64+
```yaml
65+
Type: Microsoft.SharePoint.Administration.SPOnlineProvisioning.RestrictedSiteCreationSiteType
66+
Parameter Sets: (All)
67+
Aliases:
68+
Accepted values: All, SharePoint, OneDrive, Team, Communication
69+
70+
Required: False
71+
Position: Named
72+
Default value: None
73+
Accept pipeline input: False
74+
Accept wildcard characters: False
75+
```
76+
77+
### CommonParameters
78+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
79+
80+
## INPUTS
81+
82+
### None
83+
84+
## OUTPUTS
85+
86+
### System.Object
87+
88+
## NOTES
89+
90+
## RELATED LINKS
91+
92+
[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online)
93+
94+
[Set-SPORestrictedSiteCreationForApps](Set-SPORestrictedSiteCreationForApps.md)

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -279,6 +279,9 @@ This cmdlet enables the administrator to check status of all active and availabl
279279
### [Get-SPORestrictedSiteCreation](Get-SPORestrictedSiteCreation.md)
280280
This cmdlet allows SharePoint administrators to check the current configuration of the restricted site creation feature.
281281

282+
### [Get-SPORestrictedSiteCreationForApps](Get-SPORestrictedSiteCreationForApps.md)
283+
This cmdlet allows SharePoint administrators to check the current configuration of the restricted site creation for apps feature. > [!NOTE] > This feature is currently in preview and may not be available in your tenant.
284+
282285
### [Get-SPOServicePrioritizationAppRegistrations](Get-SPOServicePrioritizationAppRegistrations.md)
283286
Retrieves the list of app registrations configured for service prioritization in SharePoint Online.
284287

@@ -726,6 +729,9 @@ Marks a site as one of multiple possible tenant's organizational news sites. Req
726729
### [Set-SPORestrictedSiteCreation](Set-SPORestrictedSiteCreation.md)
727730
Sets or updates one or more group configurations for restricting site creation.
728731

732+
### [Set-SPORestrictedSiteCreationForApps](Set-SPORestrictedSiteCreationForApps.md)
733+
Sets or updates one or more group configurations for restricting site creation for apps. > [!NOTE] > This feature is currently in preview and may not be available in your tenant.
734+
729735
### [Set-SPOServicePrioritizationAppRegistration](Set-SPOServicePrioritizationAppRegistration.md)
730736
Updates an existing app registration for service prioritization in SharePoint Online.
731737

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOContainerTypeConfiguration.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId <Guid> [-DiscoverabilityDisab
2424
[-WhoCanShareAuthenticatedGuestAllowList <Guid[]>] [-OverrideTenantWhoCanShareAnonymousAllowList <Boolean>]
2525
[-OverrideTenantWhoCanShareAuthenticatedGuestAllowList <Boolean>]
2626
[-CopilotEmbeddedChatHosts <System.Collections.Generic.List`1[System.String]>]
27-
[-AnonymousLinkExpirationInDays <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]
27+
[-AnonymousLinkExpirationInDays <Int32>] [-IsArchiveEnabled <Boolean>] [-WhatIf] [-Confirm] [<CommonParameters>]
2828
```
2929

3030
## DESCRIPTION
@@ -82,6 +82,14 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb
8282
```
8383
This example sets the host URLs for the container type with Id 4f0af585-8dcc-0000-223d-661eb2c604e4.
8484

85+
### Example 7
86+
87+
```powershell
88+
Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -IsArchiveEnabled $true
89+
```
90+
91+
Example 7 enables support for archive and reactivate actions on all the containers of ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4.
92+
8593
## PARAMETERS
8694

8795
### -AnonymousLinkExpirationInDays
@@ -171,6 +179,22 @@ Accept pipeline input: False
171179
Accept wildcard characters: False
172180
```
173181
182+
### -IsArchiveEnabled
183+
184+
Use the `-IsArchiveEnabled` flag to enable archival of containers. Archival moves data to the cold tier, reducing storage costs. While archived, content is inaccessible until reactivated. Reactivation is immediate within the first seven days and can take up to 24 hours afterward. If you don't include this flag, the value defaults to `False`, and all archive API calls fail. After you update the flag, allow up to 24 hours for the change to take effect in the consuming tenant.
185+
186+
```yaml
187+
Type: System.Boolean
188+
Parameter Sets: (All)
189+
Aliases:
190+
191+
Required: False
192+
Position: Named
193+
Default value: False
194+
Accept pipeline input: False
195+
Accept wildcard characters: False
196+
```
197+
174198
### -OverrideTenantWhoCanShareAnonymousAllowList
175199

176200
This setting determines if the container type `WhoCanShareAnonymousAllowList` overrides the tenant-level `WhoCanShareAnonymousAllowList`.
Lines changed: 216 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,216 @@
1+
---
2+
external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
3+
Module Name: Microsoft.Online.SharePoint.PowerShell
4+
online version: https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/set-sporestrictedsitecreationforapps
5+
applicable: SharePoint Online
6+
title: Set-SPORestrictedSiteCreationForApps
7+
schema: 2.0.0
8+
author: vgaddam-pm
9+
ms.author: vgaddam
10+
ms.reviewer: jmcdowe
11+
---
12+
13+
# Set-SPORestrictedSiteCreationForApps
14+
15+
## SYNOPSIS
16+
17+
Sets or updates one or more app configurations for restricting site creation.
18+
19+
## SYNTAX
20+
21+
```
22+
Set-SPORestrictedSiteCreationForApps [-Enabled <Boolean>] [-Mode <RestrictedSiteCreationMode>]
23+
[-SiteType <RestrictedSiteCreationSiteType>] [-RestrictedSiteCreationApps <String>] [-WhatIf] [-Confirm]
24+
[<CommonParameters>]
25+
```
26+
27+
## DESCRIPTION
28+
29+
This cmdlet sets or updates the configuration or setting for the Restricted Site Creation For Apps feature.
30+
31+
> [!Note]
32+
> This feature is currently in preview and may not be available in your tenant.
33+
34+
## EXAMPLES
35+
36+
### Example 1
37+
38+
```powershell
39+
Set-SPORestrictedSiteCreationForApps –Enabled:$true
40+
```
41+
42+
Example 1 enables the restricted site creation for apps feature for the tenant.
43+
44+
### Example 2
45+
46+
```powershell
47+
Set-SPORestrictedSiteCreationForApps –Mode Allow
48+
```
49+
50+
Example 2 sets restricted site creation for apps to allow mode. In this mode, an app is only able to create a site if that app is in the list specified for a matching site type.
51+
52+
### Example 3
53+
54+
```powershell
55+
Set-SPORestrictedSiteCreationForApps –SiteType "All" -RestrictedSiteCreationApps "281e395b-7316-4cb2-b5bb-8881426ee411"
56+
```
57+
58+
Example 3 updates the policy for the `All` site type to apply to the app with the app ID 281e395b-7316-4cb2-b5bb-8881426ee411. This app is now either allowed or denied (depending on the current mode) from creating all OneDrive and SharePoint sites.
59+
60+
### Example 4
61+
62+
```powershell
63+
Set-SPORestrictedSiteCreationForApps –SiteType "Team" -RestrictedSiteCreationApps "78159241-04a9-41d2-8dd4-ac568e9766a3,1f95829b-e1c8-4406-b2be-508c36f4bca5"
64+
```
65+
66+
Example 4 updates the policy for the `Team` site type to apply to the two apps specified. Both apps now either allowed or denied from creating Team sites, depending on the current mode.
67+
68+
### Example 5
69+
70+
```powershell
71+
Set-SPORestrictedSiteCreationForApps –SiteType "OneDrive" -RestrictedSiteCreationApps ""
72+
```
73+
74+
Example 5 clears the policy for the `OneDrive` site type so that it no longer applies to any apps.
75+
76+
## PARAMETERS
77+
78+
### -Enabled
79+
80+
> Applicable: SharePoint Online
81+
82+
PARAMVALUE: true | false
83+
Enables or disables Restricted Site Creation For Apps feature in tenant.
84+
85+
```yaml
86+
Type: System.Boolean
87+
Parameter Sets: (All)
88+
Aliases:
89+
90+
Required: False
91+
Position: Named
92+
Default value: None
93+
Accept pipeline input: False
94+
Accept wildcard characters: False
95+
```
96+
97+
### -Mode
98+
99+
> Applicable: SharePoint Online
100+
101+
Specifies whether policies allow or deny apps from creating sites.
102+
PARAMVALUE: Deny | Allow
103+
- Deny – an app will be blocked from creating a site if any policy applies to them.
104+
- Allow – an app will only be allowed to create a site if a policy applies to them.
105+
106+
> [!NOTE]
107+
> The restricted site creation mode is shared across all site type policies. It is not possible to use deny mode for one site type and allow mode for a different site type. When the mode is changed, all policies are cleared.
108+
109+
```yaml
110+
Type: Microsoft.SharePoint.Administration.SPOnlineProvisioning.RestrictedSiteCreationMode
111+
Parameter Sets: (All)
112+
Aliases:
113+
Accepted values: Deny, Allow
114+
115+
Required: False
116+
Position: Named
117+
Default value: None
118+
Accept pipeline input: False
119+
Accept wildcard characters: False
120+
```
121+
122+
### -RestrictedSiteCreationApps
123+
124+
> Applicable: SharePoint Online
125+
126+
A comma-separated list of up to 100 app IDs. When paired with the `–SiteType` parameter, defines a new policy which applies to the specified apps.
127+
Set to the empty string `""` to clear the policy for a site type.
128+
129+
```yaml
130+
Type: System.String
131+
Parameter Sets: (All)
132+
Aliases:
133+
134+
Required: False
135+
Position: Named
136+
Default value: None
137+
Accept pipeline input: False
138+
Accept wildcard characters: False
139+
```
140+
141+
### -SiteType
142+
143+
> Applicable: SharePoint Online
144+
145+
When paired with the `–RestrictedSiteCreationApps` parameter, creates a new policy which applies to the specified types of sites.
146+
147+
PARAMVALUE: All | SharePoint | OneDrive | Team | Communication
148+
- All - OneDrive and all SharePoint sites
149+
- SharePoint - All SharePoint sites (but not OneDrive)
150+
- OneDrive - Only OneDrive
151+
- Team - Only SharePoint team sites (group-connected and classic)
152+
- Communication - Only SharePoint communication sites
153+
154+
```yaml
155+
Type: Microsoft.SharePoint.Administration.SPOnlineProvisioning.RestrictedSiteCreationSiteType
156+
Parameter Sets: (All)
157+
Aliases:
158+
Accepted values: All, SharePoint, OneDrive, Team, Communication
159+
160+
Required: False
161+
Position: Named
162+
Default value: None
163+
Accept pipeline input: False
164+
Accept wildcard characters: False
165+
```
166+
167+
### -Confirm
168+
Prompts you for confirmation before running the cmdlet.
169+
170+
```yaml
171+
Type: System.Management.Automation.SwitchParameter
172+
Parameter Sets: (All)
173+
Aliases: cf
174+
175+
Required: False
176+
Position: Named
177+
Default value: None
178+
Accept pipeline input: False
179+
Accept wildcard characters: False
180+
```
181+
182+
### -WhatIf
183+
Shows what would happen if the cmdlet runs.
184+
The cmdlet is not run.
185+
186+
```yaml
187+
Type: System.Management.Automation.SwitchParameter
188+
Parameter Sets: (All)
189+
Aliases: wi
190+
191+
Required: False
192+
Position: Named
193+
Default value: None
194+
Accept pipeline input: False
195+
Accept wildcard characters: False
196+
```
197+
198+
### CommonParameters
199+
200+
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).
201+
202+
## INPUTS
203+
204+
### None
205+
206+
## OUTPUTS
207+
208+
### System.Object
209+
210+
## NOTES
211+
212+
## RELATED LINKS
213+
214+
[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online)
215+
216+
[Get-SPORestrictedSiteCreationForApps](Get-SPORestrictedSiteCreationForApps.md)

0 commit comments

Comments
 (0)