Documentation
    {{docApp.userSession.userId}}
    {{docApp.userSession.userName}}
    {{docApp.userSession.email}}
    Issuer : {{docApp.userSession.issuerInstance}}
    Expires : {{new Date(docApp.userSession.validUntil).toLocaleDateString()}}

{{docApp.title}}

{{docApp.description}}

INDEX

Documentation Library

Search for information on Hornbill Documentation.

{{docApp.searchError}}

{{docApp.searchResultFilteredItems.length}} results for "{{docApp.currentResultsSearchText}}" in {{docApp.searchFilterBySpecificBookTitle}}

Have questions about this site?

What is this site?

  • This website is Hornbill's new product documentation website and is currently under development.
  • It is intended that all existing and future public-facing documentation we produce will be available to search, browse and share.
  • Hornbill's current documentation is available at Hornbill Wiki but over time this content will be migrated to this documentation site.
  • Please feel free to have a look around at any time.

Why has Hornbill created this site?

  • Hornbill's products have moved on considerably since we introduced it almost 10 years ago. At the time, the MediaWiki tool was sufficient, but we have outgrown it.
  • Our customers are more enterprise focused and more self-sufficient than ever before, so for 2023 and beyond we have established a new documentation platform and team to drive our documentation initiative forwards.
  • We are aiming to deprecate the use of Hornbill Wiki for most Hornbill related documentation.
  • We want to enable our growing partner network with product resources and information, documentation beyond our Wiki approach is required.
  • We could definitely do with some help, and may even pay for some! If you have domain knowledge and would like to help, please check out our Hornbill Docs Contributor Guide and contact the Hornbill docs team at docs@hornbill.com.

What will this site be good for?

  • Community contribution will be facilitated, encouraged, and most welcome.
  • High quality documentation, will be kept up to date as rapidly as our products evolve.
  • Real-time content search and discovery.
  • Articles organized into books, books into libraries, creating a more natural and logical structure to our documentation.
  • Legacy API documentation and various other documentation sources will all be consolidated into a single unified documentation system.
  • Documentation available in browser as well as printable/viewable as PDF on demand.
  • Personalized documentation experience, allowing dark/light mode, article subscriptions, social media sharing and other useful features.
  • Almost all publicly available documentation on docs.hornbill.com will be open-source and available to fork on GitHub, allowing customers to derive their own custom documentation around Hornbill products should they wish to.

What is the timeline for this site?

  • We have taken the decision to publish and make available early, there is very little content at this time.
  • As and when we have completed/usable documentation, it will be published here.
  • We have a host of additional features we wish to add over time, so please watch this space.
  • We expect most of our existing documentation should be reviewed/migrated to docs.hornbill.com over the coming months.
  • The documentation project will be ongoing, will continue to expand, evolve and improve day-by-day.

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

{{group.title || group.id}}

{{group.description}}

  1. {{book.title}}

{{group.title}}

{{book.title}}
More...

Windows Management

  • Article
  • 4 minutes to read

Managing Windows Devices

Manage Windows devices directly from inside Hornbill with comprehensive remote capabilities

Package Details

  • Vendor: Microsoft
  • Target Platform: Windows Universal
  • Package Type: Server and Workstation Management

Why use this

Remotely troubleshoot and restore Windows devices

Empower service desk agents and IT ops teams to get user back up and running faster with direct control of Windows endpoints

Example: If an employee is having issues with their desktop, a service desk agent can access information and take actions to resolve issues remotely—without the cost and delay of a deskside visit.

Benefits

  • Accelerate service restoration
  • Reduce call times
  • Improve customer satisfaction
  • Automate mass changes to Windows Firewall rules

How to get it

  • You can try out ITOM for free (not for production use, limited runs) by installing the ITOM application from the Hornbill App Store.
  • If you would like to explore ITOM and consider subscribing, please contact your account manager here.

Requirements

  • Target machine for script execution should be running PowerShell v5.x
  • If the script execution policy on the machine executing these operations is set to Restricted, then this will need to be updated to RemoteSigned. See the Microsoft website for more information.

Authentication

When creating jobs for operations contained within this package, they need to be run on the target machine as a user who has the correct privileges within your environment. To create and securely store keys:

  • In the Configuration area of your Hornbill instance, navigate to Platform Configuration > Security > KeySafe;
  • Click on the + Create New Key button, then select Username + Password;
  • Give the KeySafe Key a Title (this is the name/identifier for the Active Directory account as you will see it when creating an IT Automation Job, or adding an IT Automation node to a Workflow);
  • Optionally add a Description;
  • Populate the Username field with the domain username for the account being used, for example: DOMAINNAME\yourusername;
  • Populate the Password field with the password for the above account;
  • Select Create Key to save.

Once you have created your KeySafe Key, you can then use it to populate the Credentials > Admin or Run As inputs when creating IT Automation Jobs from this package.

Package Automations

OperationDescription
Environment Variable - Delete This operation will delete a System Environment Variable on a Windows device.
Environment Variable - Get This operation will retrieve the value of an Environment Variable on a Windows device.
Environment Variable - Set This operation will create or overwrite the value of a System Environment Variable on a Windows device.
Firewall - Rule Disable Disables a Windows Firewall Rule, or Group of Rules. See the Disable-NetFirewallRule cmdlet documentation for more information:
Firewall - Rule Enable Enables a Windows Firewall Rule, or Group of Rules. See the Enable-NetFirewallRule cmdlet documentation for more information:
Firewall - Rule Get Retrieves details about a Windows Firewall Rule. See the Get-NetFirewallRule cmdlet documentation for more information:
Firewall - Rule New Creates a new Windows Firewall Rule. See the New-NetFirewallRule cmdlet documentation for more information:
Firewall - Rule Remove Deletes a Windows Firewall Rule. See the Remove-NetFirewallRule cmdlet documentation for more information:
Firewall - Rule Update Updates a new Windows Firewall Rule. See the Set-NetFirewallRule cmdlet documentation for more information:
Process - End This operation will end a running process on a Windows device. If more than one processes are found using the given name, then the operation will end the first one found.
Process - Get This operation will retrieve the details about a running process on a Windows device. If more than one processes are found, the operation will return details about the first one found.
Process - Start This operation will start a running process on a Windows device.
Services - Delete This operation will delete a Service from a Windows device.
Services - Get This operation will retrieve information about a Service on a Windows device.
Services - New This operation will create a new Windows Service. See the [New-Service cmdlet documentation](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.management/new-service?view=powershell-5.1) for more information.
Services - Restart This operation will restart a Service on a Windows device.
Services - Start This operation will start a Service on a Windows device.
Services - Startup Automatic This operation will set the Startup Type of a Service to Automatic on a Windows device.
Services - Startup Disabled This operation will set the Startup Type of a Service to Disabled on a Windows device.
Services - Startup Manual This operation will set the Startup Type of a Service to Manual on a Windows device.
Services - Stop This operation will stop a Service on a Windows device.
Set Execution Policy This operation will set the PowerShell Execution Policy on a Windows device.

See also

  • Version {{docApp.book.version}}
  • Node {{docApp.node}} / {{docApp.build}}
In This Document