/powershell-module-dpc

PowerShell modules to interact with Juriba DPC.

Primary LanguagePowerShellMIT LicenseMIT

Juriba DPC PowerShell Modules

Multiple PowerShell modules that can be used to interact with the Juriba DPC.

  • Juriba.DPC
  • Juriba.DPC.ServiceNow

Installation

PowerShell Gallery

All modules are published on PowerShell Gallery. Installing the module is as simple as:

Install-Module Juriba.DPC

If you are updating from a previous version of the module simply run:

Update-Module Juriba.DPC

Usage

DPC Instance

Before using the PowerShell cmdlets in this module you will need to know the URL for your Juriba DPC instance, specifically the base URL for the API. This URL is passed to all cmdlets using the -Instance parameter. For example:

Get-JuribaImportDevice -Instance https://mydpcinstance.juriba.app ...

To find the base URL for your instance of DPC:

  1. Login to DPC and navigate to your User Profile using the link on the top right of the page.
  2. Open the API Keys page.
  3. Follow the link at the top of the page to the API Documentation.
  4. Copy the URL for this page and remove "/apiv2/index.html" from the end. This is your API base URL.

Note that depending on your Juriba DPC configuration, your API base URL may or may not contain a port number.

Authentication

Before using the PowerShell cmdlets in this module you will need to generate an API Key in Juriba DPC. This key is passed to all cmdlets using the -APIKey parameter. For example:

Get-DwImportDevice -APIKey $apikey ...

We recommend storing API Keys securely using something like Microsoft.PowerShell.SecretManagement.

For more information on using API Keys see API Keys in the DPC docs.

Examples

The Examples folder contains several examples demonstrating how each of the cmdlets can be used to work with data from various sources, such as MECM and Active Directory.

Further Information

See Import API for more information about using the Data Import API endpoints.