Agent Installed Machines Report

    The ADSelfService Plus login agent protects Windows, macOS and Linux machines with multi-factor authentication (MFA), and lets users reset their passwords and unlock their accounts directly from the login screen of their machines. The Agent Installed Machines presents a list of Windows, macOS, or Linux machines on which the scheduled installation of the login agent has been successful. It provides details such as the IP addresses and names of the machines where the agent has been installed, the OSs running on those machines, the OU or Group to which the machines belong, and the version of the installed agent.

    How it works

    When the ADSelfSevice Plus login agent is installed on machines, information on the installed machine and its respective agent is stored on the ADSelfService Plus database. This report queries the ADSelfService Plus database to retrieve the stored information and presents the data in a structured format.

    Limitations

    • This report includes only successful agent installations. Failed installations are excluded and should be viewed in the Agent Installation Failures Report.
    • If the agent is installed on an offline machine, the corresponding database entry in ADSelfService Plus and the related report entry are created only when the agent connects to the ADSelfService Plus server for the first time.

    Prerequisite: You must have administrator or technician-level access to the ADSelfService Plus portal to generate and view reports.

    Generating the Agent Installed Machines Report

    Agent Installed Machines Report
    1. Log in to the ADSelfService Plus admin portal with administrator or operator privileges.
    2. Navigate to Reports > GINA(Windows)/macOS/Linux Agent Reports > Agent Installed Machines Report.
    3. Specify the domain in which to search using the Select Domain option.
    4. Specify OUs using the Select OUs option, if necessary.
    5. Click Generate.

    Customizing the Agent Installed Machines Report

    Advanced filtering

    Once the report is generated, the entries can be narrowed down based on the following parameters by clicking the Advanced Filter [ ] icon at the far-right side of the report page.

    Agent Installed Machines Report in ADSelfService Plus

    Computer Name: This option lets you refine the reports by the names of the computers the agent was installed on. The conditions available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.

    IP Address: This option lets you display results by IP address. The conditions available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.

    Location: The report entries can be narrowed-down based on the location of the computer the agent was installed on. The options available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With..

    Agent Version: The report entries can be narrowed based on the version of the agent installed. You can generate it by specifying or excluding a particular version. The options available to refine this include Contains, Does Not Contain, Equals, Is Not Equal To, Starts With, and Ends With.

    MFA Status: Entries can be narrowed-down by whether MFA is Enforced or Exempted.

    Sorting

    Click on any of the column headers to view the report's entries in ascending or descending order.

    Searching

    • Click on the search icon [ ] in order to search for specific data in the report.
    • Specific users can be searched for using attributes such as their sAMAccountName, or Display Name.
    • Searching happens using the criteria ' contains '. For example, if the username column is searched for the word " jack " , then all usernames containing the sequence " jack " will be displayed as a result.

    Automating the Agent Installed Machines Report

    • The Schedule Reports option can be used to schedule the generation of reports at specified intervals, and automatically email them to administrators or specific email addresses. Learn to schedule reports here.

    Exporting the Agent Installed Machines Report

    • The Export As option at the right corner of the page helps export the report in CSV, PDF, XLS, XLSX, HTML and CSVDE formats.

    Tips

    • The More option at the right corner of the page lists the Printable View, Send Mail, and Export Settings options.
      • The Printable View option can be used to preview and print the report.
      • The Send Mail option can be used to mail the report to the desired email addresses.
      • Additionally, you can configure custom Export Settings, such as a personalized title for the report and a header logo that you may wish to display on each page.