Skip to content

Repository files navigation

MeshCentral-ScriptTask

A script running plugin for the MeshCentral2 Project. The plugin supports PowerShell, BAT, and Bash scripts. Windows, MacOS, and Linux endpoints are all supported. PowerShell can be run on any OS that has PowerShell installed, not just Windows.

Important Note

This plugin now supports NeDB and MongoDB

Installation

Pre-requisite: First, make sure you have plugins enabled for your MeshCentral installation:

"plugins": {
"enabled": true
},

Restart your MeshCentral server after making this change.

To install, simply add the plugin configuration URL when prompted: https://raw.githubusercontent.com/ryanblenis/MeshCentral-ScriptTask/master/config.json

Features

  • Add scripts to a central store
  • Run scripts on single or multiple endpoints simultaneously -- Supports PowerShell, BAT, and Bash scripts
  • Review the return status / value of completed scripts -- Returns text or parses returned JSON for easy viewing
  • Schedule scripts for future runs on either a one-time or interval basis (minutes, hourly, daily, weekly)
  • View schedules and histories based on either node (endpoint) or script
  • Dead job detection with script replay

Usage Notes

  • Run schedules and runs the job instantly.
  • Schedule puts the events into a queue.
  • Queues are checked / run every minute.
  • Scheduled jobs only show the next scheduled job at any given time.
  • History is limited to 200 events per node/script in the viewport.
  • Historical events that have completed will delete after 90 days.
  • Jobs only run when the endpoint agent is online. They do not queue to the agent when offline, then run at the specified time.
  • Scripts are cached on the clients and verified via hash at runtime for the latest version.

Variables

  • Variables can be assigned to the following scopes: Global, Script, Mesh, and Node
  • Variables with the same name will override each other in the above order (ex. Global variable testVariable will be overridden by Script variable testVariable will be overridden by Mesh variable Test will be overridden by Node variable testVariable if they exist and apply to the node running the script)
  • Variables found in a script which do not correspond with a defined variable will be replaced with VAR_NOT_FOUND
  • Variables are assigned during job dispatch (e.g. when the job is sent to the node), so the latest script and variable values will be accounted for, should they have changed since a job or scheduled job were defined.
  • Variables in scripts must be defined by hashtags on both sides and not contain spaces. (E.g. #myVar#)

Getting Started

Drag and drop some of your favorite admin scripts on the file tree. You'll then be able to run them immediately on endpoints (nodes).

Upcoming Features

  • Take action on the results of a script
  • Variable replacement

Other Information

This is fairly new and in beta. Testing was mostly done in the latest Chrome and Firefox. No attempt was made to be compatible with older IE browsers. Endpoint testing was done on Windows 10 (1903) and OS X 10.13.

Screenshots

Device PageScript EditorSchedule Screen

About

Scripting plugin for MeshCentral

Topics

Resources

Stars

77 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
GitHub - ryanblenis/MeshCentral-ScriptTask: Scripting plugin for MeshCentral · GitHub
Skip to content

Repository files navigation

MeshCentral-ScriptTask

A script running plugin for the MeshCentral2 Project. The plugin supports PowerShell, BAT, and Bash scripts. Windows, MacOS, and Linux endpoints are all supported. PowerShell can be run on any OS that has PowerShell installed, not just Windows.

Important Note

This plugin now supports NeDB and MongoDB

Installation

Pre-requisite: First, make sure you have plugins enabled for your MeshCentral installation:

"plugins": {
"enabled": true
},

Restart your MeshCentral server after making this change.

To install, simply add the plugin configuration URL when prompted: https://raw.githubusercontent.com/ryanblenis/MeshCentral-ScriptTask/master/config.json

Features

  • Add scripts to a central store
  • Run scripts on single or multiple endpoints simultaneously -- Supports PowerShell, BAT, and Bash scripts
  • Review the return status / value of completed scripts -- Returns text or parses returned JSON for easy viewing
  • Schedule scripts for future runs on either a one-time or interval basis (minutes, hourly, daily, weekly)
  • View schedules and histories based on either node (endpoint) or script
  • Dead job detection with script replay

Usage Notes

  • Run schedules and runs the job instantly.
  • Schedule puts the events into a queue.
  • Queues are checked / run every minute.
  • Scheduled jobs only show the next scheduled job at any given time.
  • History is limited to 200 events per node/script in the viewport.
  • Historical events that have completed will delete after 90 days.
  • Jobs only run when the endpoint agent is online. They do not queue to the agent when offline, then run at the specified time.
  • Scripts are cached on the clients and verified via hash at runtime for the latest version.

Variables

  • Variables can be assigned to the following scopes: Global, Script, Mesh, and Node
  • Variables with the same name will override each other in the above order (ex. Global variable testVariable will be overridden by Script variable testVariable will be overridden by Mesh variable Test will be overridden by Node variable testVariable if they exist and apply to the node running the script)
  • Variables found in a script which do not correspond with a defined variable will be replaced with VAR_NOT_FOUND
  • Variables are assigned during job dispatch (e.g. when the job is sent to the node), so the latest script and variable values will be accounted for, should they have changed since a job or scheduled job were defined.
  • Variables in scripts must be defined by hashtags on both sides and not contain spaces. (E.g. #myVar#)

Getting Started

Drag and drop some of your favorite admin scripts on the file tree. You'll then be able to run them immediately on endpoints (nodes).

Upcoming Features

  • Take action on the results of a script
  • Variable replacement

Other Information

This is fairly new and in beta. Testing was mostly done in the latest Chrome and Firefox. No attempt was made to be compatible with older IE browsers. Endpoint testing was done on Windows 10 (1903) and OS X 10.13.

Screenshots

Device PageScript EditorSchedule Screen

About

Scripting plugin for MeshCentral

Topics

Resources

Stars

77 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - ryanblenis/MeshCentral-ScriptTask: Scripting plugin for MeshCentral · GitHub
Skip to content

Repository files navigation

MeshCentral-ScriptTask

A script running plugin for the MeshCentral2 Project. The plugin supports PowerShell, BAT, and Bash scripts. Windows, MacOS, and Linux endpoints are all supported. PowerShell can be run on any OS that has PowerShell installed, not just Windows.

Important Note

This plugin now supports NeDB and MongoDB

Installation

Pre-requisite: First, make sure you have plugins enabled for your MeshCentral installation:

"plugins": {
"enabled": true
},

Restart your MeshCentral server after making this change.

To install, simply add the plugin configuration URL when prompted: https://raw.githubusercontent.com/ryanblenis/MeshCentral-ScriptTask/master/config.json

Features

  • Add scripts to a central store
  • Run scripts on single or multiple endpoints simultaneously -- Supports PowerShell, BAT, and Bash scripts
  • Review the return status / value of completed scripts -- Returns text or parses returned JSON for easy viewing
  • Schedule scripts for future runs on either a one-time or interval basis (minutes, hourly, daily, weekly)
  • View schedules and histories based on either node (endpoint) or script
  • Dead job detection with script replay

Usage Notes

  • Run schedules and runs the job instantly.
  • Schedule puts the events into a queue.
  • Queues are checked / run every minute.
  • Scheduled jobs only show the next scheduled job at any given time.
  • History is limited to 200 events per node/script in the viewport.
  • Historical events that have completed will delete after 90 days.
  • Jobs only run when the endpoint agent is online. They do not queue to the agent when offline, then run at the specified time.
  • Scripts are cached on the clients and verified via hash at runtime for the latest version.

Variables

  • Variables can be assigned to the following scopes: Global, Script, Mesh, and Node
  • Variables with the same name will override each other in the above order (ex. Global variable testVariable will be overridden by Script variable testVariable will be overridden by Mesh variable Test will be overridden by Node variable testVariable if they exist and apply to the node running the script)
  • Variables found in a script which do not correspond with a defined variable will be replaced with VAR_NOT_FOUND
  • Variables are assigned during job dispatch (e.g. when the job is sent to the node), so the latest script and variable values will be accounted for, should they have changed since a job or scheduled job were defined.
  • Variables in scripts must be defined by hashtags on both sides and not contain spaces. (E.g. #myVar#)

Getting Started

Drag and drop some of your favorite admin scripts on the file tree. You'll then be able to run them immediately on endpoints (nodes).

Upcoming Features

  • Take action on the results of a script
  • Variable replacement

Other Information

This is fairly new and in beta. Testing was mostly done in the latest Chrome and Firefox. No attempt was made to be compatible with older IE browsers. Endpoint testing was done on Windows 10 (1903) and OS X 10.13.

Screenshots

Device PageScript EditorSchedule Screen

About

Scripting plugin for MeshCentral

Topics

Resources

Stars

77 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - ryanblenis/MeshCentral-ScriptTask: Scripting plugin for MeshCentral · GitHub
Skip to content

Repository files navigation

MeshCentral-ScriptTask

A script running plugin for the MeshCentral2 Project. The plugin supports PowerShell, BAT, and Bash scripts. Windows, MacOS, and Linux endpoints are all supported. PowerShell can be run on any OS that has PowerShell installed, not just Windows.

Important Note

This plugin now supports NeDB and MongoDB

Installation

Pre-requisite: First, make sure you have plugins enabled for your MeshCentral installation:

"plugins": {
"enabled": true
},

Restart your MeshCentral server after making this change.

To install, simply add the plugin configuration URL when prompted: https://raw.githubusercontent.com/ryanblenis/MeshCentral-ScriptTask/master/config.json

Features

  • Add scripts to a central store
  • Run scripts on single or multiple endpoints simultaneously -- Supports PowerShell, BAT, and Bash scripts
  • Review the return status / value of completed scripts -- Returns text or parses returned JSON for easy viewing
  • Schedule scripts for future runs on either a one-time or interval basis (minutes, hourly, daily, weekly)
  • View schedules and histories based on either node (endpoint) or script
  • Dead job detection with script replay

Usage Notes

  • Run schedules and runs the job instantly.
  • Schedule puts the events into a queue.
  • Queues are checked / run every minute.
  • Scheduled jobs only show the next scheduled job at any given time.
  • History is limited to 200 events per node/script in the viewport.
  • Historical events that have completed will delete after 90 days.
  • Jobs only run when the endpoint agent is online. They do not queue to the agent when offline, then run at the specified time.
  • Scripts are cached on the clients and verified via hash at runtime for the latest version.

Variables

  • Variables can be assigned to the following scopes: Global, Script, Mesh, and Node
  • Variables with the same name will override each other in the above order (ex. Global variable testVariable will be overridden by Script variable testVariable will be overridden by Mesh variable Test will be overridden by Node variable testVariable if they exist and apply to the node running the script)
  • Variables found in a script which do not correspond with a defined variable will be replaced with VAR_NOT_FOUND
  • Variables are assigned during job dispatch (e.g. when the job is sent to the node), so the latest script and variable values will be accounted for, should they have changed since a job or scheduled job were defined.
  • Variables in scripts must be defined by hashtags on both sides and not contain spaces. (E.g. #myVar#)

Getting Started

Drag and drop some of your favorite admin scripts on the file tree. You'll then be able to run them immediately on endpoints (nodes).

Upcoming Features

  • Take action on the results of a script
  • Variable replacement

Other Information

This is fairly new and in beta. Testing was mostly done in the latest Chrome and Firefox. No attempt was made to be compatible with older IE browsers. Endpoint testing was done on Windows 10 (1903) and OS X 10.13.

Screenshots

Device PageScript EditorSchedule Screen

About

Scripting plugin for MeshCentral

Topics

Resources

Stars

77 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' GitHub - ryanblenis/MeshCentral-ScriptTask: Scripting plugin for MeshCentral · GitHub
Skip to content

Repository files navigation

MeshCentral-ScriptTask

A script running plugin for the MeshCentral2 Project. The plugin supports PowerShell, BAT, and Bash scripts. Windows, MacOS, and Linux endpoints are all supported. PowerShell can be run on any OS that has PowerShell installed, not just Windows.

Important Note

This plugin now supports NeDB and MongoDB

Installation

Pre-requisite: First, make sure you have plugins enabled for your MeshCentral installation:

"plugins": {
"enabled": true
},

Restart your MeshCentral server after making this change.

To install, simply add the plugin configuration URL when prompted: https://raw.githubusercontent.com/ryanblenis/MeshCentral-ScriptTask/master/config.json

Features

  • Add scripts to a central store
  • Run scripts on single or multiple endpoints simultaneously -- Supports PowerShell, BAT, and Bash scripts
  • Review the return status / value of completed scripts -- Returns text or parses returned JSON for easy viewing
  • Schedule scripts for future runs on either a one-time or interval basis (minutes, hourly, daily, weekly)
  • View schedules and histories based on either node (endpoint) or script
  • Dead job detection with script replay

Usage Notes

  • Run schedules and runs the job instantly.
  • Schedule puts the events into a queue.
  • Queues are checked / run every minute.
  • Scheduled jobs only show the next scheduled job at any given time.
  • History is limited to 200 events per node/script in the viewport.
  • Historical events that have completed will delete after 90 days.
  • Jobs only run when the endpoint agent is online. They do not queue to the agent when offline, then run at the specified time.
  • Scripts are cached on the clients and verified via hash at runtime for the latest version.

Variables

  • Variables can be assigned to the following scopes: Global, Script, Mesh, and Node
  • Variables with the same name will override each other in the above order (ex. Global variable testVariable will be overridden by Script variable testVariable will be overridden by Mesh variable Test will be overridden by Node variable testVariable if they exist and apply to the node running the script)
  • Variables found in a script which do not correspond with a defined variable will be replaced with VAR_NOT_FOUND
  • Variables are assigned during job dispatch (e.g. when the job is sent to the node), so the latest script and variable values will be accounted for, should they have changed since a job or scheduled job were defined.
  • Variables in scripts must be defined by hashtags on both sides and not contain spaces. (E.g. #myVar#)

Getting Started

Drag and drop some of your favorite admin scripts on the file tree. You'll then be able to run them immediately on endpoints (nodes).

Upcoming Features

  • Take action on the results of a script
  • Variable replacement

Other Information

This is fairly new and in beta. Testing was mostly done in the latest Chrome and Firefox. No attempt was made to be compatible with older IE browsers. Endpoint testing was done on Windows 10 (1903) and OS X 10.13.

Screenshots

Device PageScript EditorSchedule Screen

About

Scripting plugin for MeshCentral

Topics

Resources

Stars

77 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' GitHub - ryanblenis/MeshCentral-ScriptTask: Scripting plugin for MeshCentral · GitHub
Skip to content

Repository files navigation

MeshCentral-ScriptTask

A script running plugin for the MeshCentral2 Project. The plugin supports PowerShell, BAT, and Bash scripts. Windows, MacOS, and Linux endpoints are all supported. PowerShell can be run on any OS that has PowerShell installed, not just Windows.

Important Note

This plugin now supports NeDB and MongoDB

Installation

Pre-requisite: First, make sure you have plugins enabled for your MeshCentral installation:

"plugins": {
"enabled": true
},

Restart your MeshCentral server after making this change.

To install, simply add the plugin configuration URL when prompted: https://raw.githubusercontent.com/ryanblenis/MeshCentral-ScriptTask/master/config.json

Features

  • Add scripts to a central store
  • Run scripts on single or multiple endpoints simultaneously -- Supports PowerShell, BAT, and Bash scripts
  • Review the return status / value of completed scripts -- Returns text or parses returned JSON for easy viewing
  • Schedule scripts for future runs on either a one-time or interval basis (minutes, hourly, daily, weekly)
  • View schedules and histories based on either node (endpoint) or script
  • Dead job detection with script replay

Usage Notes

  • Run schedules and runs the job instantly.
  • Schedule puts the events into a queue.
  • Queues are checked / run every minute.
  • Scheduled jobs only show the next scheduled job at any given time.
  • History is limited to 200 events per node/script in the viewport.
  • Historical events that have completed will delete after 90 days.
  • Jobs only run when the endpoint agent is online. They do not queue to the agent when offline, then run at the specified time.
  • Scripts are cached on the clients and verified via hash at runtime for the latest version.

Variables

  • Variables can be assigned to the following scopes: Global, Script, Mesh, and Node
  • Variables with the same name will override each other in the above order (ex. Global variable testVariable will be overridden by Script variable testVariable will be overridden by Mesh variable Test will be overridden by Node variable testVariable if they exist and apply to the node running the script)
  • Variables found in a script which do not correspond with a defined variable will be replaced with VAR_NOT_FOUND
  • Variables are assigned during job dispatch (e.g. when the job is sent to the node), so the latest script and variable values will be accounted for, should they have changed since a job or scheduled job were defined.
  • Variables in scripts must be defined by hashtags on both sides and not contain spaces. (E.g. #myVar#)

Getting Started

Drag and drop some of your favorite admin scripts on the file tree. You'll then be able to run them immediately on endpoints (nodes).

Upcoming Features

  • Take action on the results of a script
  • Variable replacement

Other Information

This is fairly new and in beta. Testing was mostly done in the latest Chrome and Firefox. No attempt was made to be compatible with older IE browsers. Endpoint testing was done on Windows 10 (1903) and OS X 10.13.

Screenshots

Device PageScript EditorSchedule Screen

About

Scripting plugin for MeshCentral

Topics

Resources

Stars

77 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - ryanblenis/MeshCentral-ScriptTask: Scripting plugin for MeshCentral · GitHub
Skip to content

Repository files navigation

MeshCentral-ScriptTask

A script running plugin for the MeshCentral2 Project. The plugin supports PowerShell, BAT, and Bash scripts. Windows, MacOS, and Linux endpoints are all supported. PowerShell can be run on any OS that has PowerShell installed, not just Windows.

Important Note

This plugin now supports NeDB and MongoDB

Installation

Pre-requisite: First, make sure you have plugins enabled for your MeshCentral installation:

"plugins": {
"enabled": true
},

Restart your MeshCentral server after making this change.

To install, simply add the plugin configuration URL when prompted: https://raw.githubusercontent.com/ryanblenis/MeshCentral-ScriptTask/master/config.json

Features

  • Add scripts to a central store
  • Run scripts on single or multiple endpoints simultaneously -- Supports PowerShell, BAT, and Bash scripts
  • Review the return status / value of completed scripts -- Returns text or parses returned JSON for easy viewing
  • Schedule scripts for future runs on either a one-time or interval basis (minutes, hourly, daily, weekly)
  • View schedules and histories based on either node (endpoint) or script
  • Dead job detection with script replay

Usage Notes

  • Run schedules and runs the job instantly.
  • Schedule puts the events into a queue.
  • Queues are checked / run every minute.
  • Scheduled jobs only show the next scheduled job at any given time.
  • History is limited to 200 events per node/script in the viewport.
  • Historical events that have completed will delete after 90 days.
  • Jobs only run when the endpoint agent is online. They do not queue to the agent when offline, then run at the specified time.
  • Scripts are cached on the clients and verified via hash at runtime for the latest version.

Variables

  • Variables can be assigned to the following scopes: Global, Script, Mesh, and Node
  • Variables with the same name will override each other in the above order (ex. Global variable testVariable will be overridden by Script variable testVariable will be overridden by Mesh variable Test will be overridden by Node variable testVariable if they exist and apply to the node running the script)
  • Variables found in a script which do not correspond with a defined variable will be replaced with VAR_NOT_FOUND
  • Variables are assigned during job dispatch (e.g. when the job is sent to the node), so the latest script and variable values will be accounted for, should they have changed since a job or scheduled job were defined.
  • Variables in scripts must be defined by hashtags on both sides and not contain spaces. (E.g. #myVar#)

Getting Started

Drag and drop some of your favorite admin scripts on the file tree. You'll then be able to run them immediately on endpoints (nodes).

Upcoming Features

  • Take action on the results of a script
  • Variable replacement

Other Information

This is fairly new and in beta. Testing was mostly done in the latest Chrome and Firefox. No attempt was made to be compatible with older IE browsers. Endpoint testing was done on Windows 10 (1903) and OS X 10.13.

Screenshots

Device PageScript EditorSchedule Screen

About

Scripting plugin for MeshCentral

Topics

Resources

Stars

77 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages