Set-SIAStrongAccount
SYNOPSIS
Update a strong account in SIA
SYNTAX
Set-SIAStrongAccount -secret_id <String> -secret_name <String> -secret_type <String> -account_domain <String>
[-safe <String>] [-account_name <String>] [-username <String>] [-password <SecureString>]
[-certFileName <String>] [-enable_bulk_elevation <Boolean>] [-ephemeral_domain_user_data <Hashtable>]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Updates a configured strong account for either virtual machines or databases, using credentials vaulted in CyberArk Privilege Cloud or stored directly in SIA.
EXAMPLES
Example 1
Set-SIAStrongAccount -secret_id 1234-abcd -secret_name MyAccount -username svc_sia -password $pwd -account_domain ad.example.com
Updates the specified strong account with credentials stored in SIA.
PARAMETERS
-account_domain
The domain of the strong account.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-account_name
The name of the vaulted CyberArk Privilege Cloud account.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-certFileName
The filename of the certificate to use for authentication.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-enable_bulk_elevation
Whether bulk elevation is enabled for the strong account.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-ephemeral_domain_user_data
A hashtable for ephemeral domain user configuration, with keys: ephemeral_domain_user_location, domain_controller (@{ domain_controller_name; domain_controller_netbios; domain_controller_use_ldaps; domain_controller_enable_certificate_validation; domain_controller_ldaps_certificate }) and winrm_info (@{ use_winrm_for_https; winrm_enable_certificate_validation; winrm_certificate }).
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-password
The password of the strong account credential stored in SIA, as a SecureString.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-safe
The name of the CyberArk Privilege Cloud safe where the account is vaulted.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-secret_id
The unique identifier of the strong account to update.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-secret_name
A friendly name for the strong account.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-secret_type
The strong account secret type - PCloudAccount (vaulted in Privilege Cloud) or ProvisionerUser (stored in SIA).
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-username
The username of the strong account credential stored in SIA.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
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: False
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: False
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
System.String
System.Security.SecureString
System.Management.Automation.SwitchParameter
OUTPUTS
System.Object
NOTES
Requires the DpaAdmin role.