Add-PASPersonalAdminAccount

SYNOPSIS

Adds a personal privileged account in Privilege Cloud.

SYNTAX

Add-PASPersonalAdminAccount [-address] <String> [-userName] <String> [-secret] <SecureString> [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Privilege Cloud Only.

Add personal privileged account for individual use and store in private dedicated Safe.

This capability is currently in Beta phase and will be undergoing future changes and expansion.

EXAMPLES

EXAMPLE 1

Add-PASPersonalAdminAccount -address somedomain -userName someUser -secret $SomePassword

Adds Personal Admin Account to private dedicated Safe.

EXAMPLE 2

$SecureString = ConvertTo-SecureString "Str0ngP@ssw0rd!" -AsPlainText -Force
Add-PASPersonalAdminAccount -address contoso.com -userName Bob -secret $SecureString

Creates a SecureString for the account password and adds a personal admin account for Bob.

EXAMPLE 3

[pscustomobject]@{address = 'contoso.com'; userName = 'Alice'; secret = $SecureString } | Add-PASPersonalAdminAccount

Adds a personal admin account using property values supplied via the pipeline.

EXAMPLE 4

$PersonalAccount = Add-PASPersonalAdminAccount -address contoso.com -userName Bob -secret $SecureString
$PersonalAccount.id

Adds a personal admin account and returns the id of the newly created account from the response.

PARAMETERS

-address

The name or address of the machine where the account will be used. Valid values: DNS/IP/URL where the account is managed.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-userName

Account user’s name.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-secret

Account password as SecureString

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: True
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

https://pspas.pspete.dev/commands/Add-PASPersonalAdminAccount