Running the Unit Tests

Effectively the unit tests are not unit tests but should be more thought of as an integration test as we run the cmdlets against an actual site.

Setting up your environment

Create a (modern) site collection at any location in your tenant. This site collection will be used for testing.

Running the test script

In the build folder of this project you'll find a Run-Tests.ps1 file. This script allows you to run the tests

With a Stored Credential (Recommended)

You can use a stored credential to authenticate to your site. We recommend using the Microsoft.PowerShell.SecretsManagement module. For more information about setting that one up see Authentication

./Run-Tests.ps1 -SiteUrl "https://yourtenant.sharepoint.com/sites/yoursite" -CredentialManagerLabel "yourlabel"

With credentials

$password = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force
$username = "yourname@domain.com"
./Run-Tests.ps1 -SiteUrl "https://yourtenant.sharepoint.com/sites/yoursite" -Username $username -Password $password

If you do not specify the password parameter you will be prompted to enter the password:

$username = "yourname@domain.com"
./Run-Tests.ps1 -SiteUrl "https://yourtenant.sharepoint.com/sites/yoursite" -Username $username
Enter password: