Essentials for Office 365 2.15 - User Guide

ListWorkers Parameters

The following are parameters for the ListWorkers command

Example:

Essentials -cloud listWorkers -tokenFile C:\user.token.json

Troubleshooting

This troubleshooting guide identifies some common issues that you may encounter when using Essentials and suggestions on how to resolve them.

Note that factors unique to your environment, such as the size, configuration, and complexity of your environment as well as interactions between Essentials, SharePoint, and other applications and processes, may also need to be taken into consideration.

Failed in choosing authentication type: Unable to find valid certificate path

Issue

When trying to connect to SharePoint on premises using SSL, the following error is logged:

!MESSAGE Failed in choosing authentication type!
!STACK 0
javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
at sun.security.ssl.Alerts.getSSLException(Alerts.java:192)
at sun.security.ssl.SSLSocketImpl.fatal(SSLSocketImpl.java:1949)

Reason

This error occurs when you are trying to make an SSL connection without a valid certificate.

Resolution

Download and install a Microsoft Graph certificate into your environment.

To download the certificate:

1.Go to https://graph.microsoft.com/v1.0

2.Click the lock icon to the left of the url in the address bar, select Connection is secure, then choose the appropriate option, depending on your browser:

§If using Microsoft Edge, click the certificate icon in the upper right corner.

§If using Google Chrome, select Certificate is valid.

3.On the Details tab, make sure the root certificate is selected.

4.Click [Export].

5.Give the certificate the name of your choice and save it as file type Base64-encoded ASCII, certificate chain.

To install the certificate:

Open a command window using the Run as administrator option, and install the certificate using a command like the following:

NOTE:  The actual command path may vary, depending on your environment.

<JAVA_HOME_PATH>\keytool.exe -import -trustcacerts -alias <value> -file "<certificate_path>" -keystore "<JAVA_HOME_PATH>\jre\lib\security\cacerts"

Default password: “changeit”
“yes”

EXAMPLE PATH:

"C:\Program Files\Quest\Essentials\jre\bin\keytool.exe" -import -trustcacerts -alias graphcert -file "C:\Program Files\Quest\Essentials\certs\Digital Global Root CA Certificate.crt" -keystore "C:\Program Files\Quest\Essentials\jre\lib\security\cacerts"

Migration of SPO Classic Experience site pages fail with a 401: Unauthorized error

Issue

When performing a SharePoint Online to SharePoint Online migration, the following error is logged for Classic Experience site pages:

The server sent HTTP status code 401: Unauthorized

Possible Reason

The "Allow access" option is not enabled for apps that do not use modern authentication.

Resolution

1.Open the SharePoint admin center.

2.Navigate to Policies > Access control.

3.Click Apps that don't use modern authentication and set it to Allow access.