New command: spo folder archive. Closes #7181

[Saurabh7019]

Closes #7181

[milanholemans]

Thanks! We'll try to review it ASAP.

[Adam-it]

@Saurabh7019 solid work and I only noticed one thing to correct, but I have a few things we need to recheck before we proceed:

1. If we execute this command on the library root level, we get a quite confusing error message, which does not help the user. If archiving on the root level of the document library is not possible, it would be best if we handle and catch this case and present a valuable error message to the user

2. I tested it locally, but I am not sure how to check if the folder is indeed archived 😁. I tried retrieving properties for that folder or any documents in that folder, and unfortunately non of them had any archived flag set. How did you test this command?

[Saurabh7019]

1. If we execute this command on the library root level, we get a quite confusing error message, which does not help the user. If archiving on the root level of the document library is not possible, it would be best if we handle and catch this case and present a valuable error message to the user

This is fixed.

2. I tested it locally, but I am not sure how to check if the folder is indeed archived 😁. I tried retrieving properties for that folder or any documents in that folder, and unfortunately non of them had any archived flag set. How did you test this command?

You are right.. folder properties don't have an archival status. I tested it was by manually navigating to the folder in the UI and verifying that all files within the folder were archived. also, the archival can take some time to complete, so the status won't always be reflected immediately after the command runs. Let me know if you want me to include the below response for command execution,

{
  "IsArchive": true,
  "TotalFileCount": 1,
  "CreatedUtcDateTime": "2026-05-05T07:30:52.1673964Z",
  "LastStartedUtcDateTime": "0001-01-01T00:00:00",
  "FolderArchiveStatus": "Unknown",
  "ProcessedFileCount": 0,
  "SuccessCount": 0,
  "FailureCount": 0,
  "NotArchivableFileCount": 0,
  "ProgressPercentage": 0
}

I chose not include it to keep it aligned with file-archive command.

[Adam-it]

hi, due to a patch release, we needed to perform we had to rebase the main branch, which now makes this PR out of sync with the latest state of main.
@Saurabh7019 may I kindly ask you to rebase this branch against the latest main before we proceed with the review? Thanks