與現有遠端存取工具整合

請依本指南在 Gorelo 中整合其他工具，例如 Splashtop、AnyDesk、TeamViewer 等。只要遠端存取工具支援透過 URL 啟動，例如 Splashtop、AnyDesk 或 TeamViewer，你都可以與 Gorelo 整合。此範例使用：

Splashtop Business
RustDesk
Webroot

Splashtop
RustDesk

建立自訂資產欄位。

前往 Settings > Assets > Custom Fields。
新增自訂欄位，內容如下：
- Name：Splashtop SUUID
- Variable：splashtopSUUID

撰寫指令稿。

前往 Scripts。
建立指令稿，內容如下：
- Name：Store-SplashtopSUUID
- Content：

# Define registry path for 64-bit machines
$regPath64 = "HKLM:\SOFTWARE\WOW6432Node\Splashtop Inc.\Splashtop Remote Server"

# Define the value name for the SUUID
$regValue = "SUUID"

# Try to retrieve the SUUID from the 64-bit registry
if (Test-Path $regPath64) {
    try {
        $suuid = Get-ItemProperty -Path $regPath64 -Name $regValue -ErrorAction Stop
        
        # Check if the SUUID value is present
        if ($suuid.$regValue) {
            $suuidValue = $suuid.$regValue
            Write-Output "Splashtop SUUID: $suuidValue"
            
            # Write the SUUID to the Gorelo custom field
            GoreloAction -SetCustomField -Name 'asset.splashtopSUUID' -Value $suuidValue
        } else {
            Write-Output "SUUID not found in the registry."
        }
    } catch {
        Write-Output "Error retrieving SUUID from the registry: $_"
    }
} else {
    Write-Output "Splashtop registry not found."
}

透過政策部署指令稿。

前往 Policies。
編輯涵蓋你想儲存 Splashtop SUUID 之資產的現有政策。
新增 Store-SplashtopSUUID 指令稿，並設定每天於你偏好的時間重複執行。
Save 並 distribute 政策。

建立捷徑。

前往 Asset Shortcuts。
新增捷徑，內容如下：
- Name：Splashtop
- URL：t-business://com.splashtop.business?account=&uuid={{$gorelo:asset.splashtopSUUID}}&sessiontype=remote
- Pinned Name：Splashtop
  你現在會在 Asset Detail 頁面右上角看到 SPLASHTOP 捷徑。如果指令稿成功填入 $gorelo:asset.splashtopSUUID 變數，此捷徑會啟動 Splashtop Business 應用程式。

捷徑不會安裝 Splashtop —— 需要另一個指令稿來執行此操作，例如：

# Installs Splashtop Streamer using the installer MSI uploaded to $gorelo:file.splashtopInstaller
# Runs a silent install using the 12-digit deployment key at $gorelo:client.splashtopKey

#Check for presence of SplashtopKey
if ([string]::IsNullOrEmpty($gorelo:client.splashtopKey)) {
Write-Output "No SplashTop Key stored for this client. Automatic installation cancelled."
GoreloAction -Alert -Severity 3 -Name "No Splashtop Key stored for this client" -Description "No Splashtop Key is stored in the client custom field so the automatic installation has been cancelled" -Suppress 0
} else {
Write-Output "Splashtop Key Found: " $gorelo:client.splashtopKey
Write-Output "Installer Path: " $gorelo:file.splashtopInstaller
}

#Install Splashtop
msiexec /i $gorelo:file.splashtopInstaller USERINFO="dcode=$gorelo:client.splashtopKey,hidewindow=1,confirm_d=0" /qn /norestart

強烈建議自行架設 RustDesk 伺服器，並修改初始安裝指令稿以支援。

建立自訂資產欄位。

前往 Settings > Assets > Custom Fields。
新增自訂欄位，內容如下：
- Name：RustDesk ID
- Variable：rustdeskID
新增自訂欄位，內容如下：
- Name：RustDesk Password
- Variable：rustdeskPassword

上傳安裝檔。

前往 Settings > Asset > Files
新增檔案，內容如下：
- File：上傳最新的 RustDesk MSI 安裝檔
- Variable：rustdesk

撰寫指令稿。

前往 Scripts
建立指令稿，內容如下：
- Name：Install Rustdesk
- Content：

   #Install Rusdesk
   msiexec /i $gorelo:file.rustdesk /qn /norestart CREATESTARTMENUSHORTCUTS="N" CREATEDESKTOPSHORTCUTS="N" /l*v install.log

建立指令稿，內容如下：
- Name：Write Rustdesk ID and Password
- Content：

   $RustDeskPath = "$env:ProgramFiles\RustDesk\RustDesk.exe"
   
   # Get Rustdesk ID using the executable
   $RustdeskID = cmd /c "`"$RustDeskPath`" --get-id"
   
   if ($RustdeskID) {
      # Write ID to Gorelo custom field
      GoreloAction -SetCustomField -Name 'asset.rustdeskID' -Value $RustdeskID
      Write-Output "Rustdesk ID: $RustdeskID written to Gorelo"
   
      # Generate random 16 character password
      $Password = -join ((65..90) + (97..122) + (48..57) | Get-Random -Count 16 | ForEach-Object {[char]$_})
      
      # Set the password in Rustdesk
      cmd /c "`"$RustDeskPath`" --password $Password"
      
      # Write password to Gorelo custom field
      GoreloAction -SetCustomField -Name 'asset.rustdeskPassword' -Value $Password
      Write-Output "Rustdesk password set and saved to Gorelo"
      exit 0
   } else {
      Write-Output "Failed to get Rustdesk ID"
      exit 1
   }

透過政策部署指令稿。

前往 Policies。
編輯涵蓋你想安裝並透過 RustDesk 連線之資產的現有政策。
新增 RustDesk Service 的持續性 Service check，並加入「Install Rustdesk」指令稿作為修復步驟。
新增「Write Rustdesk ID and Password」指令稿，並設定每天於你偏好的時間重複執行。
Save 並 distribute 政策。

建立捷徑。

前往 Asset Shortcuts。
新增捷徑，內容如下：
- Name：RustDesk
- URL：rustdesk://{{\$gorelo:asset.rustdeskID}}?password={{\$gorelo:asset.rustdeskPassword}}
- Pinned Name：RustDesk

你現在會在 Asset Detail 頁面右上角看到 RustDesk 捷徑。如果指令稿成功填入自訂欄位，此捷徑會啟動 RustDesk 應用程式。

Bitdefender 安裝執行檔的 URL 應如下（虛構範例）：https://cloudgz.gravityzone.bitdefender.com/Packages/BSTWIN/0/setupdownloader_[aHR0cHM6Ly9jbG91ZGdLWDawWVjcy5ncR5em9uZS5iaXRkZWZl3ddwawGfawdmRlci5jb20vUGFja2FnZXMvQlNUV0lOLzAvdkluc3RhbGxlci54bw-bGFuZz1lbi1VUw==].exe

安裝監控工具

監控

操作指南

疑難排解