{"id":353664,"date":"2024-08-27T10:09:34","date_gmt":"2024-08-27T10:09:34","guid":{"rendered":"https:\/\/www.ninjaone.com\/script-hub\/automatiser-installation-de-connectwise-screenconnect\/"},"modified":"2024-10-13T19:09:31","modified_gmt":"2024-10-13T19:09:31","slug":"automatiser-installation-de-connectwise-screenconnect","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/automatiser-installation-de-connectwise-screenconnect\/","title":{"rendered":"Guide d’automatisation de l’installation de ConnectWise ScreenConnect sur Linux, \u00e9tape par \u00e9tape"},"content":{"rendered":"

Dans le monde informatique actuel, les outils d’assistance \u00e0 distance sont indispensables pour les fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a> et les professionnels de l’informatique. Ces outils facilitent le d\u00e9pannage et la gestion des appareils distants, r\u00e9duisant ainsi les temps d’arr\u00eat<\/a> et am\u00e9liorant la productivit\u00e9.<\/p>\n

ConnectWise ScreenConnect, une solution performante d’assistance \u00e0 distance, est largement utilis\u00e9e pour ses fonctionnalit\u00e9s compl\u00e8tes et sa facilit\u00e9 d’utilisation. L’automatisation du processus d’installation de ces outils peut faire gagner beaucoup de temps. Cet article se penche sur un script Bash con\u00e7u pour t\u00e9l\u00e9charger et installer ConnectWise ScreenConnect sur les syst\u00e8mes Linux<\/strong>, en expliquant ses caract\u00e9ristiques, son utilisation et ses avantages.<\/p>\n

Contexte<\/h2>\n

ConnectWise ScreenConnect permet aux professionnels de l’informatique d’acc\u00e9der \u00e0 distance aux appareils et de les contr\u00f4ler, offrant ainsi une exp\u00e9rience d’assistance optimale. L’installation de ScreenConnect sur plusieurs appareils peut s’av\u00e9rer fastidieuse, en particulier lorsqu’une personnalisation est n\u00e9cessaire pour diff\u00e9rents param\u00e8tres organisationnels.<\/p>\n

Le script fourni automatise ce processus et permet de personnaliser divers param\u00e8tres tels que le nom de l’entreprise, le type d’appareil, la localisation, et bien plus. Cette automatisation<\/a> est particuli\u00e8rement b\u00e9n\u00e9fique pour les entreprises MSP qui g\u00e8rent de nombreux environnements clients, assurant ainsi un d\u00e9ploiement coh\u00e9rent et efficace.<\/p>\n

Le script<\/h2>\n
#!\/usr\/bin\/env bash\r\n#\r\n# Description: Download and install ConnectWise ScreenConnect. This script supports automatic customization of the company name, device type, location, and other ScreenConnect fields.\r\n# By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https:\/\/www.ninjaone.com\/terms-of-use.\r\n# Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. \r\n# Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. \r\n# Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. \r\n# Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. \r\n# Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. \r\n# Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. \r\n# EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n#\r\n# Preset Parameter: --screenconnectdomain \"replace.me\"\r\n#   Replace the text encased in quotes to have the script build the download URL and then install ScreenConnect.\r\n#\r\n# Preset Parameter: --useOrgName\r\n#   Modifies your URL to use the organization name in the \"Company Name\" Field in ScreenConnect.\r\n#\r\n# Preset Parameter: --useLocation\r\n#   Modifies your URL to use the Location Name in the \"Site\" Field in ScreenConnect.\r\n#\r\n# Preset Parameter: --deviceType \"REPLACEME\"\r\n#   Modifies your URL to fill in the \"Device Type\" field in ScreenConnect. (Either Workstation or Laptop).\r\n#\r\n# Preset Parameter: --Department \"REPLACEME\"\r\n#   Modifies your URL to fill in the Department name with the text encased in quotes\r\n#\r\n# Preset Parameter: --skipSleep\r\n#   By default, this script sleeps at a random interval (between 3 and 30 seconds) before downloading the installation file.\r\n#   This option skips the sleep interval.\r\n#\r\n# Pre-set Parameter: --help\r\n#   Displays some help text.\r\n\r\n# These are all our preset parameter defaults. You can set these = to something if you would prefer the script automatically assumed a parameter is used.\r\n_arg_screenconnectdomain=\r\n# For parameters that don't have arguments \"on\" or \"off\" is used.\r\n_arg_useOrgName=\"off\"\r\n_arg_useLocation=\"off\"\r\n_arg_department=\r\n_arg_devicetype=\r\n_arg_destfolder=\/tmp\r\n_arg_skipsleep=\"off\"\r\n_arg_installJava=\"off\"\r\n\r\n# Help text function for when invalid input is encountered\r\nprint_help() {\r\n  printf '\\n\\n%s\\n\\n' 'Usage: [--screenconnectdomain <arg>] [--useOrgName] [--useLocation] [--deviceType <arg>] [--department <arg>] [--skipSleep] [-h|--help]'\r\n  printf '\\n%s\\n' 'Preset Parameter: --screenconnectdomain \"replace.me\"'\r\n  printf '\\t%s' \"Replace the text encased in quotes with the domain used for ConnectWise ScreenConnect. e.g. 'example.screenconnect.com'\"\r\n  printf '\\n%s\\n' 'Preset Parameter: --useOrgName'\r\n  printf '\\t%s\\n' \"Modifies your URL in order to fill in the 'Company Name' field in ScreenConnect with the Organization Name.\"\r\n  printf '\\n%s\\n' 'Preset Parameter: --useLocation'\r\n  printf '\\t%s\\n' \"Modifies your URL to fill in the 'Site Name' field in ScreenConnect with the device's location as specified in Ninja.\"\r\n  printf '\\n%s\\n' 'Preset Parameter: --department \"YourDesiredDepartmentName\"'\r\n  printf '\\t%s\\n' \"Modifies your URL in order to fill in the 'Department' field in ScreenConnect with the text encased in quotes.\"\r\n  printf '\\n%s\\n' 'Preset Parameter: --devicetype \"YourDesiredDeviceType\"'\r\n  printf '\\t%s\\n' \"Modifies your URL in order to fill in the 'Device Type' field in ScreenConnect with the text encased in quotes.\"\r\n  printf '\\n%s\\n' 'Preset Parameter: --skipSleep'\r\n  printf '\\t%s\\n' \"By default this script will sleep at a random interval between 3 and 60 seconds prior to download. Use this option to skip this behavior.\"\r\n  printf '\\n%s\\n' 'Preset Parameter: --installJava'\r\n  printf '\\t%s\\n' \"Install Java if it's not already present.\"\r\n  printf '\\n%s\\n' 'Preset Parameter: --help'\r\n  printf '\\t%s\\n' \"Displays this help menu.\"\r\n}\r\n\r\n# Determines whether or not help text is necessary and routes the output to stderr\r\ndie() {\r\n  local _ret=\"${2:-1}\"\r\n  echo \"$1\" >&2\r\n  test \"${_PRINT_HELP:-no}\" = yes && print_help >&2\r\n  exit \"${_ret}\"\r\n}\r\n\r\n# Grabbing the parameters and parsing through them.\r\nparse_commandline() {\r\n  while test $# -gt 0; do\r\n    _key=\"$1\"\r\n    case \"$_key\" in\r\n    --screenconnectdomain | --domain)\r\n      test $# -lt 2 && die \"Missing value for the optional argument '$_key'.\" 1\r\n      _arg_screenconnectdomain=$2\r\n      shift\r\n      ;;\r\n    --screenconnectdomain=*)\r\n      _arg_screenconnectdomain=\"${_key##--screenconnectdomain=}\"\r\n      ;;\r\n    --useOrgName | --useorgname | --orgname)\r\n      _arg_useOrgName=\"on\"\r\n      ;;\r\n    --useLocation | --useOrgLocation | --uselocation | --location)\r\n      _arg_useLocation=\"on\"\r\n      ;;\r\n    --deviceType | --devicetype)\r\n      test $# -lt 2 && die \"Missing value for the optional argument '$_key'.\" 1\r\n      _arg_devicetype=\"$2\"\r\n      shift\r\n      ;;\r\n    --devicetype=*)\r\n      _arg_devicetype=\"${_key##--devicetype=}\"\r\n      ;;\r\n    --department | --Department)\r\n      test $# -lt 2 && die \"Missing value for the optional argument '$_key'.\" 1\r\n      _arg_department=\"$2\"\r\n      shift\r\n      ;;\r\n    --department=*)\r\n      _arg_department=\"${_key##--department=}\"\r\n      ;;\r\n    --installJava)\r\n      _arg_installJava=\"on\"\r\n      ;;\r\n    --skipsleep | --skipSleep)\r\n      _arg_skipsleep=\"on\"\r\n      ;;\r\n    --help | -h)\r\n      _PRINT_HELP=yes die 0\r\n      ;;\r\n    *)\r\n      _PRINT_HELP=yes die \"FATAL ERROR: Got an unexpected argument '$1'\" 1\r\n      ;;\r\n    esac\r\n    shift\r\n  done\r\n}\r\n\r\nparse_commandline \"$@\"\r\n\r\n# If script form is used, override command-line arguments\r\n\r\nif [[ -n $screenconnectDomainName ]]; then\r\n  _arg_screenconnectdomain=\"$screenconnectDomainName\"\r\nfi\r\n\r\nif [[ -n $installJavaIfMissing && $installJavaIfMissing == \"true\" ]]; then\r\n  _arg_installJava=\"on\"\r\nfi\r\n\r\nif [[ -n $instanceId ]]; then\r\n  _arg_instanceId=\"$instanceId\"\r\nfi\r\n\r\nif [[ -n $useNinjaOrganizationName && $useNinjaOrganizationName == \"true\" ]]; then\r\n  _arg_useOrgName=\"on\"\r\nfi\r\n\r\nif [[ -n $useNinjaLocationName && $useNinjaLocationName == \"true\" ]]; then\r\n  _arg_useLocation=\"on\"\r\nfi\r\n\r\nif [[ -n $deviceType ]]; then\r\n  _arg_devicetype=\"$deviceType\"\r\nfi\r\n\r\nif [[ -n $department ]]; then\r\n  _arg_department=\"$department\"\r\nfi\r\n\r\nif [[ -n $skipSleep && $skipSleep == \"true\" ]]; then\r\n  _arg_skipsleep=\"on\"\r\nfi\r\n\r\n# This function will download our file when we're ready for that.\r\ndownloadFile() {\r\n  i=1\r\n  while [[ $i -lt 4 ]]; do\r\n    if [[ ! $_arg_skipsleep == \"on\" ]]; then\r\n      sleepTime=$((3 + RANDOM % 30))\r\n      echo \"Sleeping for $sleepTime seconds.\"\r\n      sleep $sleepTime\r\n    fi\r\n\r\n    echo \"Download Attempt $i\"\r\n    wget -q -O \"$_arg_destfolder\/$filename\" \"$url\"\r\n\r\n    file=$_arg_destfolder\/$filename\r\n    if [[ -f $file ]]; then\r\n      echo 'Download was successful!'\r\n      i=4\r\n    else\r\n      echo 'Attempt Failed!'\r\n      ((i += 1))\r\n    fi\r\n  done\r\n}\r\n\r\n# Check if deb or rpm distro\r\nusesDeb=$(command -v dpkg)\r\nusesRpm=$(command -v rpm)\r\n\r\nif [[ -z $usesDeb && -z $usesRpm ]]; then\r\n  _PRINT_HELP=no die \"FATAL ERROR: rpm or dpkg cannot be found. ConnectWise ScreenConnect cannot be installed on this system. https:\/\/screenconnect.connectwise.com\/blog\/remote-support-access\/remote-desktop-linux\" 1\r\nfi\r\n\r\n# If we're not given a download method error out\r\nif [[ -z $_arg_screenconnectdomain ]]; then\r\n  _PRINT_HELP=yes die \"FATAL ERROR: A download url or the domain you use for ScreenConnect is required to install ScreenConnect.\" 1\r\nfi\r\n\r\npattern='^http(.?):\/\/(.*)'\r\nif [[ $_arg_screenconnectdomain =~ $pattern ]]; then\r\n  _arg_screenconnectdomain=${_arg_screenconnectdomain\/\/http*:\\\/\\\/\/}\r\n  echo \"You accidentally included http with the domain. Using '$_arg_screenconnectdomain' instead.\"\r\nfi\r\n\r\n# If the destination folder doesn't exist create it.\r\nif [[ ! -d $_arg_destfolder ]]; then\r\n  mkdir \"$_arg_destfolder\"\r\nfi\r\n\r\n# Setting filename depending on if its a Debian package or a Redhat package.\r\nif [[ -n $usesDeb ]]; then\r\n  filename=\"ClientSetup.deb\"\r\nelse\r\n  filename=\"ClientSetup.rpm\"\r\nfi\r\n\r\n# If a file already exists with that name remove it.\r\nif [[ -f \"$_arg_destfolder\/$filename\" ]]; then\r\n  rm \"$_arg_destfolder\/$filename\"\r\nfi\r\n\r\n# Start the build process\r\necho \"Building URL...\"\r\nusesPython2=$(command -v python2)\r\nusesPython3=$(command -v python3)\r\n\r\nif [[ -z $usesPython2 && -z $usesPython3 ]]; then\r\n  _PRINT_HELP=no die \"FATAL ERROR: python is required for this script to function!\"\r\nfi\r\n\r\n# For anything we put in the url we'll need to escape it as wget won't do this conversion for us.\r\nencodeURL() {\r\n  local toEncode=$1\r\n  local encodedURL\r\n\r\n  if [[ -n $usesPython3 ]]; then\r\n    encodedURL=$(python3 -c \"import urllib.parse;print(urllib.parse.quote('$toEncode'))\")\r\n  else\r\n    encodedURL=$(python2 -c \"import urllib;print urllib.quote('$toEncode')\")\r\n  fi\r\n  echo \"$encodedURL\"\r\n}\r\n\r\ncompanyName=$(encodeURL \"$NINJA_COMPANY_NAME\")\r\nbaseURL=\"https:\/\/$_arg_screenconnectdomain\/Bin\/$companyName.$filename?e=Access&y=Guest\"\r\n\r\n# If the technician specified --useOrgName (or any other switch\/flag) we set it to \"on\" when we parse the parameters\r\nif [[ $_arg_useOrgName == \"on\" ]]; then\r\n  orgName=$(encodeURL \"$NINJA_ORGANIZATION_NAME\")\r\n  baseURL=\"$baseURL&c=$orgName\"\r\nelse\r\n  # If they decided to not use that field we just leave it blank so ScreenConnect will skip over it.\r\n  baseURL=\"$baseURL&c=\"\r\nfi\r\n\r\nif [[ $_arg_useLocation == \"on\" ]]; then\r\n  location=$(encodeURL \"$NINJA_LOCATION_NAME\")\r\n  baseURL=\"$baseURL&c=$location\"\r\nelse\r\n  baseURL=\"$baseURL&c=\"\r\nfi\r\n\r\nif [[ -n $_arg_department ]]; then\r\n  _arg_department=$(encodeURL \"$_arg_department\")\r\n  baseURL=\"$baseURL&c=$_arg_department\"\r\nelse\r\n  baseURL=\"$baseURL&c=\"\r\nfi\r\n\r\nif [[ -n $_arg_devicetype ]]; then\r\n  _arg_devicetype=$(encodeURL \"$_arg_devicetype\")\r\n  baseURL=\"$baseURL&c=$_arg_devicetype&c=&c=&c=&c=\"\r\nelse\r\n  baseURL=\"$baseURL&c=&c=&c=&c=&c=\"\r\nfi\r\n\r\nurl=\"$baseURL\"\r\necho \"URL Built: $url\"\r\n\r\n# At this point we should have everything setup for us to be able to download the file.\r\ndownloadFile\r\n\r\n# Lets check if the download was a success\r\nfile=\"$_arg_destfolder\/$filename\"\r\nif [[ ! -f $file ]]; then\r\n  _PRINT_HELP=no die \"FATAL ERROR: The Installation File has failed to download please try again.\" 1\r\nfi\r\n\r\n# Grabs a list of all installed packages and then filters it by connectwisecontrol-yourinstanceid\r\nif [[ -n $usesDeb ]]; then\r\n  packageName=$(dpkg --info $file | grep \"Package: \" | sed 's\/Package: \/\/g')\r\n  installedPkg=$(dpkg -l | grep \"$packageName\")\r\nelse\r\n  packageName=$(rpm -qp $file --info | grep \"Name\" | sed 's\/Name *: \/\/g')\r\n  installedPkg=$(rpm -q \"$packageName\" | grep -v \"installed\")\r\nfi\r\n\r\nif [[ -n $installedPkg ]]; then\r\n  echo \"ConnectWise ScreenConnect is already installed!\"\r\n  exit 0\r\nelse\r\n  echo \"ConnectWise ScreenConnect is not installed. Installing...\"\r\nfi\r\n\r\n# Checking for dependencies and if they're not installed install them\r\njavaIsInstalled=$(java -version 2>&1 | grep Runtime)\r\nif [[ -z $javaIsInstalled && $_arg_installJava == \"on\" ]]; then\r\n  echo \"Java is not installed. Java is required to install ConnectWise ScreenConnect. Attempting to install automatically.\"\r\n  if [[ -n $usesDeb ]]; then\r\n    if apt-get update; then\r\n      echo \"Updated apt package repos successfully. Installing default-jre...\"\r\n      if apt-get install -y default-jre; then\r\n        echo \"Default jre installed successfully!\"\r\n      else\r\n        rm \"$file\"\r\n        _PRINT_HELP=no die \"FATAL ERROR: Failed to install default-jre using apt-get! We recommend fixing this prior to attempting to install ScreenConnect.\" 1\r\n      fi\r\n    else\r\n      rm \"$file\"\r\n      _PRINT_HELP=no die \"FATAL ERROR: Failed to update package repositories using apt-get update! We recommend fixing this prior to attempting to install ScreenConnect.\" 1\r\n    fi\r\n  else\r\n    usesDnf=$(command -v dnf)\r\n    if [[ -n $usesDnf ]]; then\r\n      if dnf install java -y; then\r\n        echo \"Installed latest jre successfully!\"\r\n      else\r\n        rm \"$file\"\r\n        _PRINT_HELP=no die \"FATAL ERROR: Failed to install latest jre using dnf! We recommend fixing this prior to attempting to install ScreenConnect.\" 1\r\n      fi\r\n    else\r\n      if yum install java -y; then\r\n        echo \"Installed latest jre successfully!\"\r\n      else\r\n        rm \"$file\"\r\n        _PRINT_HELP=no die \"FATAL ERROR: Failed to install latest jre using yum! We recommend fixing this prior to attempting to install ScreenConnect.\" 1\r\n      fi\r\n    fi \r\n  fi\r\nelif [[ -z $javaIsInstalled ]]; then\r\n  rm \"$file\"\r\n  _PRINT_HELP=no die \"FATAL ERROR: Please check the box 'Install Java If Missing' in order to have this script install Java as it is required.\"\r\nelse\r\n  echo \"Java is installed!\"\r\nfi\r\n\r\n# Start installing\r\necho \"Installing application...\"\r\nif [[ -n $usesDeb ]]; then\r\n  if dpkg -i \"$file\"; then\r\n    echo \"Exit Code: $?\"\r\n    echo \"ConnectWise ScreenConnect Installed Successfully!\"\r\n    rm \"$file\"\r\n    exit 0\r\n  else\r\n    echo \"Exit Code: $?\"\r\n    rm \"$file\"\r\n    _PRINT_HELP=no die \"FATAL ERROR: The Installation has failed!\" 1\r\n  fi\r\nelse\r\n  if rpm -i \"$file\"; then\r\n    echo \"Exit Code: $?\"\r\n    echo \"ConnectWise ScreenConnect Installed Successfully!\"\r\n    rm \"$file\"\r\n    exit 0\r\n  else\r\n    echo \"Exit Code: $?\"\r\n    rm \"$file\"\r\n    _PRINT_HELP=no die \"FATAL ERROR: The Installation has failed!\" 1\r\n  fi\r\nfi<\/pre>\n
 <\/p>\n\n
<\/div>\n
Description d\u00e9taill\u00e9e<\/h2>\n
Le script est structur\u00e9 de mani\u00e8re \u00e0 faciliter le t\u00e9l\u00e9chargement et l’installation de ConnectWise ScreenConnect de fa\u00e7on automatis\u00e9e sur les syst\u00e8mes Linux. Voici une description d\u00e9taill\u00e9e de son fonctionnement :<\/p>\n