Skip to content

The unofficial Okta administrator module for PowerShell. Leverages the Okta .NET SDK to automate administrator and developer tasks in your Okta org. Compatible with Windows PowerShell 5.1, and PowerShell Core on Windows, Linux, and Mac.

Notifications You must be signed in to change notification settings

mattmcnabb/Okta

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Azure Pipelines PowerShell Gallery Github
Build Status PowerShell Gallery Github Releases

Okta module for PowerShell

Description

A PowerShell module for administering and automating your Okta org. It leverages the official Okta .Net SDK, but is unofficial and is not supported by Okta in any way. Runs on Windows PowerShell or cross-platform on PowerShell Core for Windows, Mac and Linux.

Requirements

Windows PowerShell v5.1 PowerShell Core 6+ (Linux, Mac, or Windows)

Getting Started

Install and import the module

In a PowerShell console run Install-Module Okta and confirm that you'd like to install the module. Once installed, you can import the module by running Import-Module Okta.

Create an Okta API token

In order to make calls against the Okta API, you'll need to generate an API token in the administrator console. Instructions for this can be found here. Keep in mind that this token will only be granted the same administrative privileges as the account that created it. Some commands in this module may not work properly if your API token does not have permission to perform some actions.

Connect to your Okta org

Connect-Okta -OktaDomain https://myorg.okta.com -ApiToken "00wc414Z6FMkJyLnXTPfQTl3JpeiFniYa8j4avjVPe"

View an existing connection:

Get-OktaConnection

Disconnect from your org

Disconnect-Okta

Or you can simply remove or re-import the module.

Get a user by identifier

Get-OktaUser -Identity jlannister

Get users with a filter

Get-OktaUser -Filter 'status eq "ACTIVE"'

Get apps

Get-OktaApp -All

Get groups

Get-OktaUser -Filter 'status eq "ACTIVE"'

Get system event logs

Get-OktaLogEvent -StartDate 6/1/2019

Other commands

You can find other commands to explore and manage groups, roles, events and more by running Get-Command -Module Okta.

About

The unofficial Okta administrator module for PowerShell. Leverages the Okta .NET SDK to automate administrator and developer tasks in your Okta org. Compatible with Windows PowerShell 5.1, and PowerShell Core on Windows, Linux, and Mac.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published