UPDATE EPV USER

USE THIS FUNCTION TO UPDATE AN EPV USER

Update-VPASEPVUser [-LookupBy] <String> [-LookupVal] <String> [[-UpdateWorkStreet] <String>] [[-UpdateWorkCity] <String>] [[-UpdateWorkState] <String>] [[-UpdateWorkZip] <String>] [[-UpdateWorkCountry] <String>] [[-UpdateHomePage] <String>] [[-UpdateHomeEmail] <String>] [[-UpdateBusinessEmail] <String>] [[-UpdateOtherEmail] <String>] [[-UpdateHomeNumber] <String>] [[-UpdateBusinessNumber] <String>] [[-UpdateCellularNumber] <String>] [[-UpdateFaxNumber] <String>] [[-UpdatePagerNumber] <String>] [[-UpdateEnableUser] <String>] [[-UpdateChangePassOnNextLogon] <String>] [[-UpdatePasswordNeverExpires] <String>] [[-UpdateDescription] <String>] [[-UpdateLocation] <String>] [[-UpdateStreet] <String>] [[-UpdateCity] <String>] [[-UpdateState] <String>] [[-UpdateZip] <String>] [[-UpdateCountry] <String>] [[-UpdateTitle] <String>] [[-UpdateOrganization] <String>] [[-UpdateDepartment] <String>] [[-UpdateProfession] <String>] [[-UpdateFirstName] <String>] [[-UpdateMiddleName] <String>] [[-UpdateLastName] <String>] [[-AddVaultAuthorization] <String>] [[-DeleteVaultAuthorization] <String>] [[-token] <Hashtable>] [<CommonParameters>]

-LookupBy <String>
Which method will be used to query for the target EPVUser, via Username or UserID
Possible values: Username, UserID

Required: true
Position: 1
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-LookupVal <String>
Target searchquery string

Required: true
Position: 2
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateWorkStreet <String>
EPVUser new WorkStreet value

Required: false
Position: 3
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateWorkCity <String>
EPVUser new WorkCity value

Required: false
Position: 4
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateWorkState <String>
EPVUser new WorkState value

Required: false
Position: 5
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateWorkZip <String>
EPVUser new WorkZip value

Required: false
Position: 6
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateWorkCountry <String>
EPVUser new WorkCountry value

Required: false
Position: 7
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateHomePage <String>
EPVUser new HomePage value

Required: false
Position: 8
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateHomeEmail <String>
EPVUser new HomeEmail value

Required: false
Position: 9
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateBusinessEmail <String>
EPVUser new BusinessEmail value

Required: false
Position: 10
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateOtherEmail <String>
EPVUser new OtherEmail value

Required: false
Position: 11
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateHomeNumber <String>
EPVUser new HomeNumber value

Required: false
Position: 12
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateBusinessNumber <String>
EPVUser new BusinessNumber value

Required: false
Position: 13
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateCellularNumber <String>
EPVUser new CellularNumber value

Required: false
Position: 14
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateFaxNumber <String>
EPVUser new Faxnumber value

Required: false
Position: 15
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdatePagerNumber <String>
EPVUser new PagerNumber value

Required: false
Position: 16
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateEnableUser <String>
Enable or Disable current state of EPVUser
Possible values: Enable, Disable

Required: false
Position: 17
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateChangePassOnNextLogon <String>
Enable or Disable ChangePassOnNextLogon restriction
Possible values: Yes, No

Required: false
Position: 18
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdatePasswordNeverExpires <String>
Enable ot Disable PasswordNeverExpires restriction
Possible values: Yes, No

Required: false
Position: 19
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateDescription <String>
EPVUser new Descripion value

Required: false
Position: 20
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateLocation <String>
EPVUser new Location value

Required: false
Position: 21
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateStreet <String>
EPVUser new Street value

Required: false
Position: 22
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateCity <String>
EPVUser new City value

Required: false
Position: 23
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateState <String>
EPVUser new State value

Required: false
Position: 24
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateZip <String>
EPVUser new Zip value

Required: false
Position: 25
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateCountry <String>
EPVUser new Country value

Required: false
Position: 26
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateTitle <String>
EPVUser new Title value

Required: false
Position: 27
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateOrganization <String>
EPVUser new Organization value

Required: false
Position: 28
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateDepartment <String>
EPVUser new Department value

Required: false
Position: 29
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateProfession <String>
EPVUser new Profession value

Required: false
Position: 30
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateFirstName <String>
EPVUser new FirstName value

Required: false
Position: 31
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateMiddleName <String>
EPVUser new MiddleName value

Required: false
Position: 32
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UpdateLastName <String>
EPVUser new LastName value

Required: false
Position: 33
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-AddVaultAuthorization <String>
Add VaultAuthorization permissions in addition to current permissions to target EPVUser
Possible values: AddUpdateUsers, AddSafes, AddNetworkAreas, ManageDirectoryMapping, ManageServerFileCategories, AuditUsers, BackupAllSafes, RestoreAllSafes, ResetUsersPasswords, ActivateUsers

Required: false
Position: 34
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-DeleteVaultAuthorization <String>
Delete specific existing VaultAuthorizations from target EPVUser
Possible values: AddUpdateUsers, AddSafes, AddNetworkAreas, ManageDirectoryMapping, ManageServerFileCategories, AuditUsers, BackupAllSafes, RestoreAllSafes, ResetUsersPasswords, ActivateUsers

Required: false
Position: 35
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-token <Hashtable>
HashTable of data containing various pieces of login information (PVWA, LoginToken, HeaderType, etc).
If -token is not passed, function will use last known hashtable generated by New-VPASToken

Required: false
Position: 36
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug
ErrorAction, ErrorVariable, WarningAction, WarningVariable
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216)

$UpdateEPVUserJSON = Update-VPASEPVUser -Username {USERNAME VALUE} -Location {LOCATION VALUE} -ChangePasswordOnNextLogon true

If successful:
{
         "enableUser": true,
         "changePassOnNextLogon": false,
         "expiryDate": null,
         "suspended": false,
         "lastSuccessfulLoginDate": 1723779044,
         "unAuthorizedInterfaces": [
                
         ],
         "authenticationMethod": [
                 "AuthTypePass"
         ],
         "passwordNeverExpires": false,
         "distinguishedName": "",
         "description": "New user for documentation",
         "businessAddress": {
                 "workStreet": "42 Wallaby Way",
                 "workCity": "Sydney",
                 "workState": "",
                 "workZip": "",
                 "workCountry": "Australia"
         },
         "internet": {
                 "homePage": "",
                 "homeEmail": "",
                 "businessEmail": "",
                 "otherEmail": ""
         },
         "phones": {
                 "homeNumber": "",
                 "businessNumber": "",
                 "cellularNumber": "",
                 "faxNumber": "",
                 "pagerNumber": ""
         },
         "personalDetails": {
                 "street": "",
                 "city": "",
                 "state": "",
                 "zip": "",
                 "country": "",
                 "title": "",
                 "organization": "",
                 "department": "",
                 "profession": "",
                 "firstName": "",
                 "middleName": "",
                 "lastName": ""
         },
         "id": 245,
         "username": "NewUser",
         "source": "CyberArk",
         "userType": "EPVUser",
         "componentUser": false,
         "groupsMembership": [
                
         ],
         "vaultAuthorization": [
                
         ],
         "location": "\\"
}

$false if failed