Skip to content

Update Set-SPOTenant to add FileLevelArchive parameters. #1079

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Ruchika-mittal01 merged 4 commits into from
Nov 17, 2025
Merged

Update Set-SPOTenant to add FileLevelArchive parameters. #1079

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
ade1ece
Update Set-SPOTenant to add FileLevelArchive parameters.
HectorRMota Nov 17, 2025
5344aee
Update documentation for AllowFileArchive settings
HectorRMota Nov 17, 2025
66b45e5
Merge branch 'main' into patch-2
HectorRMota Nov 17, 2025
ac87d30
Merge branch 'main' into patch-2
Ruchika-mittal01 Nov 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 56 additions & 5 deletions sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,8 @@ Set-SPOTenant [-MinCompatibilityLevel <Int32>] [-MaxCompatibilityLevel <Int32>]
[-OpticalCharacterRecognitionSelectedSitesListOperation <SelectedSitesListOperations>]
[-DefaultContentCenterSite <String>]
[-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled <Boolean>] [-EnforceRequestDigest <Boolean>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>] [<CommonParameters>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>]
[-AllowFileArchive <Boolean>] [-AllowFileArchiveByDefault <Boolean>] [<CommonParameters>]
```

### ParameterSetContentTypeSyncSiteTemplatesList
Expand Down Expand Up @@ -264,7 +265,8 @@ Set-SPOTenant [-MinCompatibilityLevel <Int32>] [-MaxCompatibilityLevel <Int32>]
[-OpticalCharacterRecognitionSelectedSitesListOperation <SelectedSitesListOperations>]
[-DefaultContentCenterSite <String>]
[-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled <Boolean>] [-EnforceRequestDigest <Boolean>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>] [<CommonParameters>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>]
[-AllowFileArchive <Boolean>] [-AllowFileArchiveByDefault <Boolean>] [<CommonParameters>]
```

### ParamSetMultipleSites
Expand Down Expand Up @@ -390,7 +392,8 @@ Set-SPOTenant [-MinCompatibilityLevel <Int32>] [-MaxCompatibilityLevel <Int32>]
[-OpticalCharacterRecognitionSelectedSitesListOperation <SelectedSitesListOperations>]
[-DefaultContentCenterSite <String>]
[-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled <Boolean>] [-EnforceRequestDigest <Boolean>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>] [<CommonParameters>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>]
[-AllowFileArchive <Boolean>] [-AllowFileArchiveByDefault <Boolean>] [<CommonParameters>]
```

### InformationBarrier
Expand Down Expand Up @@ -514,7 +517,8 @@ Set-SPOTenant [-MinCompatibilityLevel <Int32>] [-MaxCompatibilityLevel <Int32>]
[-OpticalCharacterRecognitionSelectedSitesListOperation <SelectedSitesListOperations>]
[-DefaultContentCenterSite <String>]
[-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled <Boolean>] [-EnforceRequestDigest <Boolean>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>] [<CommonParameters>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>]
[-AllowFileArchive <Boolean>] [-AllowFileArchiveByDefault <Boolean>] [<CommonParameters>]
```

### ParameterSetNameRestrictExternalSharing
Expand Down Expand Up @@ -639,7 +643,8 @@ Set-SPOTenant [-MinCompatibilityLevel <Int32>] [-MaxCompatibilityLevel <Int32>]
[-DefaultContentCenterSite <String>]
[-AllowWebPropertyBagUpdateWhenDenyAddAndCustomizePagesIsEnabled <Boolean>] [-EnforceRequestDigest <Boolean>]
[-RestrictResourceAccountAccess <Boolean>] [-RestrictExternalSharingForAgents <Boolean>]
-RestrictExternalSharing <Guid[]> [-AddAppIdToList] [-RemoveAppIdFromList] [<CommonParameters>]
-RestrictExternalSharing <Guid[]> [-AddAppIdToList] [-RemoveAppIdFromList]
[-AllowFileArchive <Boolean>] [-AllowFileArchiveByDefault <Boolean>] [<CommonParameters>]
```

## DESCRIPTION
Expand Down Expand Up @@ -1129,6 +1134,52 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowFileArchive

> Applicable: SharePoint Online

Controls whether file-level archiving is allowed at the tenant level. This setting can be overridden for specific sites by the site-level flag of the same name and has no effect unless M365 Archive is enabled for your organization.
Copy link
Contributor

@samkabue samkabue Nov 17, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

M365

this is a brand name so should be "Microsoft 365 Archive"

here and elsewhere in your doc #Closed

Copy link
Contributor Author

@HectorRMota HectorRMota Nov 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated


The valid values are:

- True (default) - Allows users to manually archive files on sites where file-level archiving is also enabled. Manual archiving is limited to internal users with write access to the file.
- False - Blocks manual archiving for all files, regardless of the site-level setting. Admin-defined policies can still archive files automatically.

```yaml
Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowFileArchiveOnNewSitesByDefault

> Applicable: SharePoint Online

Specifies the default value of the AllowFileArchive property for newly created SharePoint sites. This determines whether new sites allow file-level archiving by default. M365 Archive and the tenant-level AllowFileArchive setting must both be enabled for manual archiving to work when this property is set to True.
Copy link
Contributor

@samkabue samkabue Nov 17, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AllowFileArchive

add backticks to this, i.e.

`AllowFileArchive`

here and elsewhere #Closed

Copy link
Contributor Author

@HectorRMota HectorRMota Nov 17, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated


The valid values are:

- True (default) - Sets AllowFileArchive to True for all newly provisioned sites. M365 Archive and the tenant-level AllowFileArchive setting must both be enabled for manual archiving to work on future provisioned sites.
- False - Sets AllowFileArchive to False for all newly provisioned sites.

```yaml
Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False
```

### -AllowGuestUserShareToUsersNotInSiteCollection

> Applicable: SharePoint Online
Expand Down