Import-EpsV1Data
Documentation out of date
The documentation below was written for a different copy of this script than the one published now. Read the script itself before you run it, or ask support@invardia.com.
- the .doc.json names no sha256 of the script it documents
- the .doc.json is for version 2.0.69, the published script is 2.0.107
The published script's own summary: Shows what a v1 Entra Policy Suite install's rules and settings become in Entra Policy Suite 2.0. Writes nothing.
Purpose
Reads a v1 Entra Policy Suite folder (the tagging CSV files and the two configs) and shows the plan: the rule cards, tag types and values, settings, break-glass accounts, admin units, target groups and service tags, with the hints on the rules. It writes nothing. The import itself is done in the web app (Overview > Import v1, a SuperAdmin): upload the same files, look at the plan, approve - Entra Policy Suite writes it. With -Apply the script lists the files to upload.
When to run it
Before the move from v1, to see the plan on the machine that has the v1 folder - optional: the Import v1 page shows the same plan.
Who may run it
| Kind | Role | Scope | Why |
|---|---|---|---|
| other | read access to the v1 folder | the v1 DATA folder | the CSV files and configs are read |
What it changes
Nothing - it only reads.
What it only reads
- the v1 folder (never changed)
Parameters
| Parameter | Required | Default | What it does |
|---|---|---|---|
| -Path | yes | the v1 DATA folder, or the folder that holds DATA | |
| -UserTaggingScript | no | <Path>\Entra-Policy-Suite\Entra-ID-User-Tagging.ps1 | for the attribute per tag type |
| -OutFile | no | also save the plan as JSON | |
| -Apply | no | false | list the files to upload on the Import v1 page (nothing is written) |
| -ConnectionString | no | no longer used - the script never connects to the database |
Preview with -WhatIf
The script always only reads and shows; -WhatIf changes nothing about that.
Undo
Nothing to undo: the script writes nothing. An import made on the Import v1 page is journaled in the change history and its rules can be removed as a set; the v1 install is never changed, so v1 keeps running until it is switched off.
Download and run
Run these lines in PowerShell: the first downloads the script into the current folder, the second runs it.
Invoke-WebRequest https://invardia.com/support/eps/Import-EpsV1Data.ps1 -OutFile Import-EpsV1Data.ps1
.\Import-EpsV1Data.ps1 -Path <Path>To check the download first, compare its SHA-256 with the published one:
SHA-256 1cec1791c598795aef44700cf4d0a8efc89508a99f252e8b4aa3dd8be5e39235
Checksums: SHA256SUMS.txt · Version 2.0.107 · Documentation for version 2.0.69
Before you run it, compare the file's SHA-256 with its line in SHA256SUMS.txt.
Every parameter: Get-Help .\Import-EpsV1Data.ps1 -Full · Source: Import-EpsV1Data.ps1
Every script, identity and permission for your security review: Entra Policy Suite