Usage examples contain incorrect function names and logic errors

[TriggerAu]

In doing some work on a test framework to read and create Okta user profiles I looked at the read me and found the following issues in the below

okta-powershell-cli/docs/OktaUserApi.md

Lines 286 to 313 in f78b2c6

	# general setting of the PowerShell module, e.g. base URL, authentication, etc
	$Configuration = Get-OktaConfiguration
	# Configure your client ID and scope for authorization
	$Configuration.ClientId = "YOUR_CLIENT_ID"
	$Configuration.Scope = "OKTA_SCOPES" # for example okta.users.read
	$PasswordCredentialHash = Initialize-PasswordCredentialHash -Algorithm "BCRYPT" -Salt "MySalt" -SaltOrder "MySaltOrder" -Value "MyValue" -WorkFactor 0
	$PasswordCredentialHook = Initialize-PasswordCredentialHook -Type "MyType"
	$PasswordCredential = Initialize-PasswordCredential -Hash $PasswordCredentialHash -Hook $PasswordCredentialHook -Value "MyValue"
	$AuthenticationProvider = Initialize-AuthenticationProvider -Name "MyName" -Type "ACTIVE_DIRECTORY"
	$RecoveryQuestionCredential = Initialize-RecoveryQuestionCredential -Answer "MyAnswer" -Question "MyQuestion"
	$UserCredentials = Initialize-UserCredentials -Password $PasswordCredential -Provider $AuthenticationProvider -RecoveryQuestion $RecoveryQuestionCredential
	$UserType = Initialize-UserType -Created (Get-Date) -CreatedBy "MyCreatedBy" -Default $false -Description "MyDescription" -DisplayName "MyDisplayName" -Id "MyId" -LastUpdated (Get-Date) -LastUpdatedBy "MyLastUpdatedBy" -Name "MyName" -Links @{ key_example = }
	$CreateUserRequest = Initialize-CreateUserRequest -Credentials $UserCredentials -GroupIds "MyGroupIds" -VarProfile -Type $UserType # CreateUserRequest |
	$Activate = $true # Boolean | Executes activation lifecycle operation when creating the user (optional) (default to $true)
	$Provider = $true # Boolean | Indicates whether to create a user with a specified authentication provider (optional) (default to $false)
	$NextLogin = "changePassword" # UserNextLogin | With activate=true, set nextLogin to ""changePassword"" to have the password be EXPIRED, so user must change it the next time they log in. (optional)
	# Create a User
	try {
	$Result = New-OktaUser -Body $Body -Activate $Activate -Provider $Provider -NextLogin $NextLogin
	} catch {
	Write-Host ("Exception occurred when calling New-OktaUser: {0}" -f ($_.ErrorDetails | ConvertFrom-Json))
	Write-Host ("Response headers: {0}" -f ($_.Exception.Response.Headers | ConvertTo-Json))
	}

Annotated some issues I found here:

1. These function names are missing the Okta after the dash
2. This call is missing the parameter to pass in to VarProfile
3. there is no value in the key_example

The VarProfile would need an object that contains the username, etc for the new user as a secondary bit once the code is able to run

A quick search of the broader readme's shows these repeated in a few places too

I did look to correct these in a PR, but Im not up to scratch enough on how the management.yaml is created to do this one quickly. If there is any sort of crib sheet on how to tweak these lemme know and I can help with these

[laura-rodriguez]

Thank you for reporting this issue and for continuing to help us make this tool better, @TriggerAu!

As you said, we must review the Okta OpenAPI spec and the templates. I filed an internal ticket for the team to review and prioritize in the upcoming planning rounds.

Internal Ref: OKTA-825952