> ## 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.

# 透過自訂客戶欄位安裝軟體

> 使用以特定客戶的自訂欄位（金鑰、token、租戶 ID）的 Gorelo 指令稿安裝 Cove、SentinelOne、BitDefender 與 Webroot 等軟體。

依本指南安裝 SentinelOne、Cove、DNSFilter 等。

自訂客戶欄位可在指令稿中用來搭配客戶特有資訊（金鑰、token 等）安裝軟體。

此範例安裝：

* Cove
* SentinelOne
* BitDefender
* Webroot

<Tabs>
  <Tab title="Cove">
    <Steps>
      <Step title="建立客戶自訂欄位。">
        1. 前往 **Settings** > **CRM** > **[<u>Custom Fields</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u>。</u>**
        2. 新增自訂欄位，內容如下：
           * **Name**：Cove Customer UID
           * **Variable**：CoverCustomerUID
      </Step>

      <Step title="為每個客戶填入 Cove Customer UID。">
        1. 前往特定客戶。
        2. 點擊 **Custom Fields。**
        3. 編輯 **Cove Customer UID。**
        4. 輸入從 Cove 取得的 Customer UID。
      </Step>

      <Step title="撰寫指令稿。">
        1. 前往 **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>。</u>**
        2. 建立指令稿，內容如下：
           * **Name**：Install-Cove
           * **Content**：

        ```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="建立客戶自訂欄位。">
        1. 前往 **Settings** > **CRM** > **[<u>Custom Fields</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u>：</u>**
        2. 新增自訂欄位，內容如下：
           * **Name**：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="為每個客戶填入軟體 token。">
        1. 前往特定客戶
        2. 點擊 **Custom Fields。**
                   <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. 編輯 **SentinelOne Site Token**。
        4. 輸入從 SentinelOne 取得的 Site Token。
                   <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>
           可從 https\://\<DomainName>.[**sentinelone.net/dashboard**](http://sentinelone.net/dashboard) 取得你的 SentinelOne Site Token。前往一個 Site，然後到 **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="建立安裝檔。">
        1. 前往 **Settings** > Asset > **[<u>Files</u>](https://app.gorelo.io/Admin/admin-settings#asset#filerepository)<u>。</u>**
        2. 新增檔案，內容如下：
           * **File**：上傳最新的 MSI 安裝檔
           * **Variable**：S1Installer
      </Step>

      <Step title="撰寫指令稿。">
        1. 前往 **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>。</u>**
        2. 建立指令稿，內容如下：
           * **Name**：Install-SentineOne。
           * **Content**：

        ```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="透過政策部署指令稿。">
        1. 前往 **[<u>Policies</u>](https://app.gorelo.io/Asset/policy-management)<u>。</u>**
        2. 編輯涵蓋你想安裝 SentinelOne 之資產的現有政策。
        3. 新增 **Install-SentineOne** 指令稿，並設定每天於你偏好的時間重複執行。
        4. **Distribute** 政策。
      </Step>
    </Steps>
  </Tab>

  <Tab title="BitDefender">
    <Steps>
      <Step title="建立客戶自訂欄位。">
        1. 前往 **Settings** > **CRM** > **[<u>Custom Fields</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u>。</u>**
        2. 新增自訂欄位，內容如下：
           * **Name**：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="為每個客戶填入 BitDefender URL。">
        1. 前往特定客戶。
        2. 點擊 **Custom Fields。**
                   <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. 編輯 **Bitdefender URL**。
        4. 為每個客戶輸入從 Bitdefender 取得的安裝 exe URL。
                   <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>
                     Bitdefender 安裝 exe 的 URL 應如下（虛構範例）：`htttps://cloudgz.gravityzone.bitdefender.com/Packages/BSTWIN/0/setupdownloader_[aHR0cHM6Ly9jbG91ZGdLWDawWVjcy5ncR5em9uZS5iaXRkZWZl3ddwawGfawdmRlci5jb20vUGFja2FnZXMvQlNUV0lOLzAvdkluc3RhbGxlci54bw-bGFuZz1lbi1VUw==].exe`
                   </Tip>
      </Step>

      <Step title="撰寫指令稿。">
        1. 前往 **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>。</u>**
        2. 建立指令稿，內容如下：
           * **Name**：Install-Bitdefender
           * **Content**：

        ```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="透過政策部署指令稿。">
        1. 前往 **[<u>Policies</u>](https://app.gorelo.io/Asset/policy-management)<u>。</u>**
        2. 編輯涵蓋你想安裝 Bitdefender 之資產的現有政策。
        3. 新增 **Install-Bitdefender** 指令稿，並設定每天於你偏好的時間重複執行。
        4. **Distribute** 政策。
      </Step>
    </Steps>
  </Tab>

  <Tab title="Webroot">
    <Steps>
      <Step title="建立客戶自訂欄位。">
        1. 前往 **Settings** > **CRM** > **[<u>Custom Fields</u>](https://app.gorelo.io/Admin/admin-settings#crm#clientcustomfields)<u>。</u>**
        2. 新增自訂欄位，內容如下：
           * **Name**：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="為每個客戶填入 Webroot key。">
        1. 前往特定客戶。
        2. 點擊 **Custom Fields。**
                   <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. 編輯 **Webroot Key**。
        4. 輸入\*\*[從 Webroot 取得的](https://answers.webroot.com/Webroot/ukp.aspx?pid=17\&app=vw\&vw=1\&solutionid=984)\*\* Webroot Key。
                   <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="建立安裝檔。">
        1. 前往 **Settings** > Asset > **[<u>Files</u>](https://app.gorelo.io/Admin/admin-settings#asset#filerepository)<u>。</u>**
        2. 新增檔案，內容如下：
           * **File**：上傳最新的 MSI 安裝檔
           * **Variable**：webrootInstaller
      </Step>

      <Step title="建立指令稿。">
        1. 前往 **[<u>Scripts</u>](https://app.gorelo.io/Asset/script-list)<u>。</u>**
        2. 建立指令稿，內容如下：
           * **Name**：Install-Webroot
           * **Content**：

        ```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="透過政策部署指令稿">
        1. 前往 **[<u>Policies</u>](https://app.gorelo.io/Asset/policy-management)<u>。</u>**
        2. 編輯涵蓋你想安裝 Webroot 之資產的現有政策。
        3. 新增 **Install-Webroot** 指令稿，並設定每天於你偏好的時間重複執行。
        4. **Distribute** 政策。

        或者，你可以將該指令稿加為 Service Check 的修復步驟，例如：

        <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>