> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installer un logiciel via des champs personnalisés de client

> Installez des logiciels comme Cove, SentinelOne, BitDefender et Webroot avec des scripts Gorelo qui utilisent des champs personnalisés spécifiques au client pour les clés, jetons et identifiants de locataire.

Suivez ce guide pour installer SentinelOne, Cove, DNSFilter, etc.

Les champs personnalisés de client peuvent être utilisés dans des scripts pour installer des logiciels avec des informations propres au client (clés, jetons, etc.).

Cet exemple installe :

* Cove
* SentinelOne
* BitDefender
* Webroot

<Tabs>
  <Tab title="Cove">
    <Steps>
      <Step title="Créez le champ personnalisé de client.">
        1. Allez à **Paramètres** > **CRM** > **[<u>Champs personnalisés</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u>.</u>**
        2. Ajoutez un champ personnalisé avec les détails suivants :
           * **Nom** : Cove Customer UID
           * **Variable** : CoverCustomerUID
      </Step>

      <Step title="Renseignez le Cove Customer UID pour chaque client.">
        1. Allez à un client spécifique.
        2. Cliquez sur **Champs personnalisés**.
        3. Modifiez **Cove Customer UID**.
        4. Saisissez le Customer UID récupéré depuis Cove.
      </Step>

      <Step title="Écrivez le script.">
        1. Allez à **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>.</u>**
        2. Créez un script avec les détails suivants :
           * **Nom** : Install-Cove
           * **Contenu** :

        ```powershell theme={null}
        # ===== Configuration Variables =====
        $CUSTOMERUID = $gorelo:client.CoveCustomerUID
        $PROFILEID = "All-in" # Default retention policy
        $PRODUCT = "0" # Profile ID (use "0" for no profile or a specific profile ID)
        $DOWNLOADPATH = "C:\Windows\Temp"
        # ===================================

        $startTime = Get-Date
        $INSTALL = "$DOWNLOADPATH\bm#$CUSTOMERUID#$PROFILEID#.exe"

        # Download installer
        try {
            [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
            (New-Object System.Net.WebClient).DownloadFile("https://cdn.cloudbackup.management/maxdownloads/mxb-windows-x86_x64.exe", "$INSTALL")
        } catch {
            Write-Output "ERROR: Failed to download installer - $_"
            exit 1
        }

        # Run installer
        try {
            Start-Process -FilePath $INSTALL -ArgumentList "-product-name `"$PRODUCT`"" -Wait -NoNewWindow
            Start-Sleep -Seconds 5
        } catch {
            Write-Output "ERROR: Installation failed - $_"
            exit 1
        }

        # Verify installation
        $service = Get-Service -Name "Backup Service Controller" -ErrorAction SilentlyContinue
        $process = Get-Process -Name "BackupFP" -ErrorAction SilentlyContinue

        if ($service.Status -eq 'Running' -and $process) {
            Write-Output "SUCCESS: Backup Service Controller is running and BackupFP process is active."
            Write-Output "Installed for Customer UID: $CUSTOMERUID"
            $exitCode = 0
        } else {
            Write-Output "WARNING: Backup Service Controller or BackupFP process is not running as expected."
            Write-Output "Customer UID: $CUSTOMERUID"
            
            # Check log for errors
            $logDirectory = "C:\ProgramData\mxb\Backup Manager\logs\ClientTool"
            if (Test-Path $logDirectory) {
                $latestLog = Get-ChildItem -Path $logDirectory -Filter "*.log" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
                if ($latestLog) {
                    $errorLines = Get-Content -Path $latestLog.FullName | Where-Object { $_ -match '\[E\]' } | Select-Object -Last 3
                    if ($errorLines) {
                        Write-Output "Recent errors from log:"
                        $errorLines | ForEach-Object { Write-Output $_ }
                    }
                }
            }
            $exitCode = 1
        }

        $endTime = Get-Date
        Write-Output "Installation completed in $([math]::Round(($endTime - $startTime).TotalSeconds, 2)) seconds."
        exit $exitCode
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="SentinelOne">
    <Steps>
      <Step title="Créez le champ personnalisé de client.">
        1. Allez à **Paramètres** > **CRM** > **[<u>Champs personnalisés</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u> :</u>**
        2. Ajoutez un champ personnalisé avec les détails suivants :
           * **Nom** : SentinelOne Site Token
           * **Variable** : s1token

        <Frame>
          <img src="https://mintcdn.com/gorelo/-gDoUuq9lm8_69OG/images/image-87.png?fit=max&auto=format&n=-gDoUuq9lm8_69OG&q=85&s=031f83e7ab18bcf33261433dacae33df" alt="Image" width="782" height="624" data-path="images/image-87.png" />
        </Frame>
      </Step>

      <Step title="Renseignez le jeton logiciel pour chaque client.">
        1. Allez à un client spécifique.
        2. Cliquez sur **Champs personnalisés**.
                   <Frame>
                     <img src="https://mintcdn.com/gorelo/-gDoUuq9lm8_69OG/images/image-88.png?fit=max&auto=format&n=-gDoUuq9lm8_69OG&q=85&s=b7c8ddd252eb239aaf67ef9f00553e47" alt="Image" width="699" height="914" data-path="images/image-88.png" />
                   </Frame>
        3. Modifiez **SentinelOne Site Token**.
        4. Saisissez le Site Token récupéré depuis SentinelOne.
                   <Frame>
                     <img src="https://mintcdn.com/gorelo/-gDoUuq9lm8_69OG/images/image-89.png?fit=max&auto=format&n=-gDoUuq9lm8_69OG&q=85&s=937c28444f16ea4989b6fc99af96f7ee" alt="Image" width="678" height="386" data-path="images/image-89.png" />
                   </Frame>
           Vous pouvez récupérer votre SentinelOne Site Token depuis https\://\<NomDuDomaine>.[**sentinelone.net/dashboard**](http://sentinelone.net/dashboard). Allez à un site, puis à l'onglet **Site Info**.
                   <Frame>
                     <img src="https://mintcdn.com/gorelo/-gDoUuq9lm8_69OG/images/image-90.png?fit=max&auto=format&n=-gDoUuq9lm8_69OG&q=85&s=baef851dc57746d91b1bc79658c23bb4" alt="Image" width="1641" height="617" data-path="images/image-90.png" />
                   </Frame>
      </Step>

      <Step title="Créez le fichier d'installation.">
        1. Allez à **Paramètres** > Actif > **[<u>Fichiers</u>](https://app.gorelo.io/Admin/admin-settings#asset#filerepository)<u>.</u>**
        2. Ajoutez un fichier avec les détails suivants :
           * **Fichier** : téléversez le dernier installeur MSI.
           * **Variable** : S1Installer
      </Step>

      <Step title="Écrivez le script.">
        1. Allez à **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>.</u>**
        2. Créez un script avec les détails suivants :
           * **Nom** : Install-SentineOne.
           * **Contenu** :

        ```powershell theme={null}
        #Silently install SentinelOne

        if($gorelo:client.s1token){

          $S1Service = get-service -Name 'Sentinel Agent' -ErrorAction SilentlyContinue

          if($S1Service -eq $null){

                msiexec /i $gorelo:file.S1Installer SITE_TOKEN=$gorelo:client.s1token /quiet /norestart
               
          }
        }
        ```
      </Step>

      <Step title="Déployez le script via une politique.">
        1. Allez à **[<u>Politiques</u>](https://app.gorelo.io/Asset/policy-management)<u>.</u>**
        2. Modifiez une politique existante qui couvre les actifs sur lesquels vous voulez installer SentinelOne.
        3. Ajoutez le script **Install-SentineOne** et configurez-le pour qu'il se répète quotidiennement à l'heure de votre choix.
        4. **Distribuez** la politique.
      </Step>
    </Steps>
  </Tab>

  <Tab title="BitDefender">
    <Steps>
      <Step title="Créez le champ personnalisé de client.">
        1. Allez à **Paramètres** > **CRM** > **[<u>Champs personnalisés</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u>.</u>**
        2. Ajoutez un champ personnalisé avec les détails suivants :
           * **Nom** : Bitdefender URL
           * **Variable** : bitdefenderURL

        <Frame>
          <img src="https://mintcdn.com/gorelo/T3NJMN-hVMIJ4iQN/images/image-105.png?fit=max&auto=format&n=T3NJMN-hVMIJ4iQN&q=85&s=c3008e52a40d2950813499b65dc391f2" alt="Image" width="803" height="644" data-path="images/image-105.png" />
        </Frame>
      </Step>

      <Step title="Renseignez l'URL BitDefender pour chaque client.">
        1. Allez à un client spécifique.
        2. Cliquez sur **Champs personnalisés**.
                   <Frame>
                     <img src="https://mintcdn.com/gorelo/T3NJMN-hVMIJ4iQN/images/image-106.png?fit=max&auto=format&n=T3NJMN-hVMIJ4iQN&q=85&s=c1073ee7cec0fb54745993497c098996" alt="Image" width="699" height="914" data-path="images/image-106.png" />
                   </Frame>
        3. Modifiez **Bitdefender URL**.
        4. Saisissez l'URL de l'exécutable d'installation récupérée depuis Bitdefender pour chaque client.
                   <Frame>
                     <img src="https://mintcdn.com/gorelo/T3NJMN-hVMIJ4iQN/images/image-107.png?fit=max&auto=format&n=T3NJMN-hVMIJ4iQN&q=85&s=d8e2868ac6c7ec0192e2e2d1f1ce2064" alt="Image" width="704" height="414" data-path="images/image-107.png" />
                   </Frame>
                   <Tip>
                     L'URL Bitdefender pour l'exécutable d'installation devrait ressembler à ceci (exemple fictif) : `htttps://cloudgz.gravityzone.bitdefender.com/Packages/BSTWIN/0/setupdownloader_[aHR0cHM6Ly9jbG91ZGdLWDawWVjcy5ncR5em9uZS5iaXRkZWZl3ddwawGfawdmRlci5jb20vUGFja2FnZXMvQlNUV0lOLzAvdkluc3RhbGxlci54bw-bGFuZz1lbi1VUw==].exe`
                   </Tip>
      </Step>

      <Step title="Écrivez le script.">
        1. Allez à **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>.</u>**
        2. Créez un script avec les détails suivants :
           * **Nom** : Install-Bitdefender
           * **Contenu** :

        ```powershell theme={null}
        #$gorelo:client.bitdefenderURL

        # Check if Bitdefender is already installed
        if (Get-Service -Name "EPProtectedService" -ErrorAction SilentlyContinue) {
            Write-Host "Bitdefender is already installed. Skipping installation."
            exit 0
        }

        # Proceed with installation
        $url = $gorelo:client.bitdefenderURL
        $filename = Split-Path $url -Leaf
        $installer = Join-Path $env:TEMP $filename

        Write-Host "Downloading Bitdefender installer..."
        (New-Object System.Net.WebClient).DownloadFile($url, $installer)

        Write-Host "Installing Bitdefender..."
        Start-Process -FilePath $installer -ArgumentList "/silent" -Wait
        Remove-Item -LiteralPath $installer

        # Verify installation
        Start-Sleep -Seconds 10  # Give the service time to start
        $service = Get-Service -Name "EPProtectedService" -ErrorAction SilentlyContinue

        if ($service -and $service.Status -eq "Running") {
            Write-Host "Installation successful! EPProtectedService is running."
            exit 0
        } else {
            Write-Host "Installation may have failed. EPProtectedService not found or not running."
            exit 1
        }
        ```
      </Step>

      <Step title="Déployez le script via une politique.">
        1. Allez à **[<u>Politiques</u>](https://app.gorelo.io/Asset/policy-management)<u>.</u>**
        2. Modifiez une politique existante qui couvre les actifs sur lesquels vous voulez installer Bitdefender.
        3. Ajoutez le script **Install-Bitdefender** et configurez-le pour qu'il se répète quotidiennement à l'heure de votre choix.
        4. **Distribuez** la politique.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Webroot">
    <Steps>
      <Step title="Créez le champ personnalisé de client.">
        1. Allez à **Paramètres** > **CRM** > **[<u>Champs personnalisés</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u>.</u>**
        2. Ajoutez un champ personnalisé avec les détails suivants :
           * **Nom** : Webroot Key
           * **Variable** : webrootKey

        <Frame>
          <img src="https://mintcdn.com/gorelo/vclHs_96o-5AzbEe/images/image-102.png?fit=max&auto=format&n=vclHs_96o-5AzbEe&q=85&s=94afcc15964d77a73b1f06a85397187f" alt="Image" width="749" height="585" data-path="images/image-102.png" />
        </Frame>
      </Step>

      <Step title="Renseignez la clé Webroot pour chaque client.">
        1. Allez à un client spécifique.
        2. Cliquez sur **Champs personnalisés**.
                   <Frame>
                     <img src="https://mintcdn.com/gorelo/vclHs_96o-5AzbEe/images/image-103.png?fit=max&auto=format&n=vclHs_96o-5AzbEe&q=85&s=29d3f4f00950d7dabc7b019d6c81f7f0" alt="Image" width="699" height="914" data-path="images/image-103.png" />
                   </Frame>
        3. Modifiez **Webroot Key**.
        4. Saisissez la clé Webroot **[récupérée depuis Webroot](https://answers.webroot.com/Webroot/ukp.aspx?pid=17\&app=vw\&vw=1\&solutionid=984)**.
                   <Frame>
                     <img src="https://mintcdn.com/gorelo/vclHs_96o-5AzbEe/images/image-104.png?fit=max&auto=format&n=vclHs_96o-5AzbEe&q=85&s=c340167502bfba8e2933ac0d7b68a23e" alt="Image" width="673" height="399" data-path="images/image-104.png" />
                   </Frame>
      </Step>

      <Step title="Créez le fichier d'installation.">
        1. Allez à **Paramètres** > Actif > **[<u>Fichiers</u>](https://app.gorelo.io/Admin/admin-settings#asset#filerepository)<u>.</u>**
        2. Ajoutez un fichier avec les détails suivants :
           * **Fichier** : téléversez le dernier installeur MSI.
           * **Variable** : webrootInstaller
      </Step>

      <Step title="Créez le script.">
        1. Allez à **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>.</u>**
        2. Créez un script avec les détails suivants :
           * **Nom** : Install-Webroot
           * **Contenu** :

        ```powershell theme={null}
        # Silently install Webroot
        if($gorelo:client.webrootKey){
            $WebrootService = Get-Service -Name 'WRSVC' -ErrorAction SilentlyContinue
            if($WebrootService -eq $null){
                msiexec /i $gorelo:file.webrootInstaller GUILIC=$gorelo:client.webrootKey CMDLINE=SME,quiet /qn /l*v install.log
            }
        }
        ```
      </Step>

      <Step title="Déployez le script via une politique">
        1. Allez à **[<u>Politiques</u>](https://app.gorelo.io/Asset/policy-management)<u>.</u>**
        2. Modifiez une politique existante qui couvre les actifs sur lesquels vous voulez installer Webroot.
        3. Ajoutez le script **Install-Webroot** et configurez-le pour qu'il se répète quotidiennement à l'heure de votre choix.
        4. **Distribuez** la politique.

        Vous pouvez également ajouter le script comme étape de remédiation pour une vérification de service, par exemple :

        <Frame>
          <img src="https://mintcdn.com/gorelo/T3NJMN-hVMIJ4iQN/images/image-105.png?fit=max&auto=format&n=T3NJMN-hVMIJ4iQN&q=85&s=c3008e52a40d2950813499b65dc391f2" alt="Image" width="803" height="644" data-path="images/image-105.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>