What is This?

This is a PowerShell integration for Division of Management Information at University of Illinois at Urbana-Champaign. This is the system used to join information from sources like CDB to find out who an asset belongs to.

How do I install it?

This is currently windows only for the time being

1. Install Powershell 7, you have options for this. Chocolatey or GitHub.
2. For the current GA release you can use the PSGallery or you can use the provided Makefile to set it up from the repository.

How does it work?

1. Using the URL specified in the settings.json file DMI information will be fetched via the provided unauthenticated tab separated web page.
2. This information is then stored in a local SQLite database for better performance and to ensure the data is available if the webpage is down.
3. By default the module will update the local DB from the URL at import unless UpdateCacheOnImport is set to false in settings.json.
4. Typical use after installing is just going straight to the Get-DMIDepartment command after opening your shell.

How do I help?

1. Ensure naming schemes are kept consistent with the Verb-DMINoun convention.
2. Ensure the docs folder is kept up to date as well as the comment based help. The docs are generated via the PlatyPS module available on the PS Gallery.
3. Any new functionality should have associated pester tests added to the UofIDMI.Tests.ps1 file and by extension no PR should be accepted without passing pester tests.
4. If your changes justify a release, increment the version number appropriately and create one on GitHub and a release to the gallery should trigger via actions.

To Do

1. Incorporate code coverage tests into the CI.