Cette commande est disponible pour les utilisateurs d’Office 365. L’authentification OAuth (protocole OAuth2) est utilisée pour accéder aux fichiers SharePoint.
Une fois authentifié, cette commande permettra de lister tous les sites SharePoint adressables grâce au jeton OAuth2 obtenu.
Afin de s’authentifier, il faut fournir notamment les éléments suivants à la commande :
- Microsoft Entra ID (tenant ID) : paramètre Tenant
- ID client de l'application : paramètre ClientIdVal
- Valeur secrète de l'application : paramètre ClientSecretVal
Bien entendu, ces informations n’apparaitront pas dans la trace Launcher.
Pour plus d’infos, allez voir ce chapitre de notre documentation.
Par ailleurs voici un lien sur la documentation Microsoft.
Syntaxe
|
CHGVAR |
VAR(&CMD) VALUE('SHRDPTLIST') |
|
CHGVAR |
VAR(&PARM1)
VALUE(' ;ClientSecretVal="client secret" ;Tenant="tenant" ;Detailed=true/false |
|
CALL |
PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT) |
Paramètres
|
Paramètres |
|
|
Parm1 ou Parm2 |
ClientIdVal : Client ID. Utile pour l’authentification.
ClientSecretVal : Client Secret. Utile pour l’authentification.
Tenant : Tenant. Utile pour l’authentification.
Detailed : True/False (par défaut). Si False, la liste des URLs des sites, séparés par des points virgules, est retourné par la commande. Si True, le fichier "list_sharepoint_sites.txt" sera créé dans le répertoire %TEMP% du PC/Serveur Windows hébergeant le serveur Launcher/400. Pour chaque site, le fichier contiendra les éléments suivants : Internal name, URL, ID, Displayed Name.
|
Exemple
L’exemple suivant permet de lister tous les sites SharePoint adressables grâce au jeton OAuth2 obtenu.
LNCCMD CMD(SHRDPTLIST) +
PARM1('clientIdVal="45ai88a7-8f43-1289-b698-45ca+
23c87a84";clientSecretVal="Odf9Q~ecCrfgGAPv+
N8df89cxb7dx52df7CVBLbaI";Tenant="a2f8vf56-+
2178-4da9-b478-2fe147a5";Detailed=true')
Voici un exemple de contenu du fichier "%TEMP%\list_sharepoint_sites.txt" généré quand le paramètre Detailed=true :
- Internal name : SalesandMarketing
- URL : https://aura.sharepoint.com/sites/SalesandMarketing
- ID : aura.sharepoint.com,fb686d99-0fbd-4e0e-2224-d7ad7cb8745f,abe22aaa-1962 - - Displayed name : Sales and Marketing
--------------------------------------------------
- Internal name : Retail
- URL : https://aura.sharepoint.com/sites/Retail
- ID : aura.sharepoint.com,e5fb8c77-111d-4992-b35d-a542d9c0ee72,abe22aaa-1962-- Displayed name : Retail
--------------------------------------------------