التكامل مع أدوات الوصول عن بُعد الموجودة

اتبع هذا الدليل لدمج أدوات أخرى في Gorelo، مثل Splashtop وAnyDesk وTeamViewer وغيرها. يمكنك دمج Gorelo مع أي أداة وصول عن بُعد تدعم التشغيل عبر URL، مثل Splashtop أو AnyDesk أو TeamViewer. يستخدم هذا المثال:

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 واضبطه على التكرار يوميًا في الوقت المفضل لديك.
احفظ ووزّع السياسة.

إنشاء الاختصار.

انتقل إلى Asset Shortcuts.
أضف اختصارًا جديدًا بالتفاصيل التالية:
- Name: Splashtop
- URL: t-business://com.splashtop.business?account=&uuid={{$gorelo:asset.splashtopSUUID}}&sessiontype=remote
- Pinned Name: Splashtop
  يجب أن ترى الآن اختصار SPLASHTOP في الزاوية العلوية اليمنى من صفحة Asset Detail. إذا نجح النص في ملء متغير $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: ارفع أحدث مثبّت MSI لـ RustDesk
- 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.
أضف فحص Service مستمر لـ RustDesk Service. أضف نص ‘Install Rustdesk’ كخطوة إصلاح.
أضف نص ‘Write Rustdesk ID and Password’ واضبطه على التكرار يوميًا في الوقت المفضل لديك.
احفظ ووزّع السياسة.

إنشاء الاختصار.

انتقل إلى Asset Shortcuts.
أضف اختصارًا جديدًا بالتفاصيل التالية:
- Name: RustDesk
- URL:rustdesk://{{\$gorelo:asset.rustdeskID}}?password={{\$gorelo:asset.rustdeskPassword}}
- Pinned Name: RustDesk

يجب أن ترى الآن اختصار RustDesk في الزاوية العلوية اليمنى من صفحة Asset Detail. إذا نجح النص في ملء الحقول المخصصة، فسيشغّل هذا الاختصار تطبيق RustDesk.

يجب أن يبدو عنوان URL لـ Bitdefender لمثبّت exe كما يلي (مثال وهمي):https://cloudgz.gravityzone.bitdefender.com/Packages/BSTWIN/0/setupdownloader_[aHR0cHM6Ly9jbG91ZGdLWDawWVjcy5ncR5em9uZS5iaXRkZWZl3ddwawGfawdmRlci5jb20vUGFja2FnZXMvQlNUV0lOLzAvdkluc3RhbGxlci54bw-bGFuZz1lbi1VUw==].exe

تثبيت أدوات المراقبة

المراقبة

أدلة الكيفية

استكشاف الأخطاء وإصلاحها

التكامل مع أدوات الوصول عن بُعد الموجودة