Set HPOVUser - HewlettPackard/POSH-HPEOneView GitHub Wiki

Modify an existing user account.

Set-HPOVUser [-UserName] <String> [-Password] <String> [-FullName] <String> [-Roles] <Array>[ [-ScopePermissions] <Array>] [-EmailAddress] <String> [-OfficePhone] <String> [-MobilePhone] <String>[ [-Enabled] <SwitchParameter>][ [-Disabled] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

Set-HPOVUser [-UserObject] <Object> [-Password] <String> [-FullName] <String> [-Roles] <Array>[ [-ScopePermissions] <Array>] [-EmailAddress] <String> [-OfficePhone] <String> [-MobilePhone] <String>[ [-Enabled] <SwitchParameter>][ [-Disabled] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

Modify or update an existing local user account on the management appliance. This cmdlet will not update the password or roles of the currently logged in user account. To update your HPE OneView appliance local account"s password, please use the Set-HPOVUserPassword cmdlet.

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Default Value: ${Global:ConnectedSessions} | ? Default

-Disabled <SwitchParameter>

Disable the local user account.

-EmailAddress <String>

Updated Email Address of the User Account.

-Enabled <SwitchParameter>

Enable the local user account.

-FullName <String>

Updated Full Name of the User Account.

-MobilePhone <String>

Updated mobile phone number

-OfficePhone <String>

Updated office phone of the User Account.

-Password <String>

New password for the user account. Passwords must be at least 8 characters.

-Roles <Array>

Aliases [-r, -role] The role(s) to assign to the Directroy Group, in System.Collections.ArrayList format. Accepted values are noted within the ApplianceRoles property of the HPOneView.Appliance.Connection object stored in the $Global:ConnectedSessions variable.

Example: $roles = "Server administrator","Network administrator"

-ScopePermissions <Array>

Array collection of Hashtable<Role; Scope>. Will overwrite existing scope to role mappings.

Example: -ScopePermissions @{Role = "Network administrator"; Scope = (Get-HPOVScope -Name CorpNetAdmins -ErrorAction Stop) }

-UserName <String>

The name or object of the user account to be updated.

-UserObject <Object>

The object of the user account to be updated.

<CommonParameters>

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

HPOneView.Appliance.User [System.Management.Automation.PSCustomObject]

HPE OneView User Account object created on an appliance

HPOneView.Appliance.User [System.Management.Automation.PSCustomObject]

If successful, returns a user resource

 -------------------------- EXAMPLE 1 --------------------------

Set-HPOVUser -username Sally -roles @("server administrator","network administrator")

Update the user account "Sally" with new roles.

 -------------------------- EXAMPLE 2 --------------------------

Set-HPOVUser -username Sally -password NewP@ssw0rd

Update the user account "Sally" with a new password.

 -------------------------- EXAMPLE 3 --------------------------

$Scope = Get-HPOVScope -Name Scope1 -ErrorAction Stop
Get-HPOVUser -Username Sally | Set-HPOVUser -Roles "Server administrator" -ScopePermissions @{Role = "Network administrator"; Scope = $Scope }

Modify the user account with the new role and scope permissions.

• Get-HPOVUser
• New-HPOVUser
• Remove-HPOVUser
• Set-HPOVUserPassword
• Set-HPOVUserRole
• Show-HPOVUserSession

Modify an existing user account.

Set-HPOVUser [-UserName] <String> [-Password] <String> [-FullName] <String> [-Roles] <Array>[ [-ScopePermissions] <Array>] [-EmailAddress] <String> [-OfficePhone] <String> [-MobilePhone] <String>[ [-Enabled] <SwitchParameter>][ [-Disabled] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

Set-HPOVUser [-UserObject] <Object> [-Password] <String> [-FullName] <String> [-Roles] <Array>[ [-ScopePermissions] <Array>] [-EmailAddress] <String> [-OfficePhone] <String> [-MobilePhone] <String>[ [-Enabled] <SwitchParameter>][ [-Disabled] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

Modify or update an existing local user account on the management appliance. This cmdlet will not update the password or roles of the currently logged in user account. To update your HPE OneView appliance local account's password, please use the Set-HPOVUserPassword cmdlet.

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Default Value: ${Global:ConnectedSessions} | ? Default

-Disabled <SwitchParameter>

Disable the local user account.

-EmailAddress <String>

Updated Email Address of the User Account.

-Enabled <SwitchParameter>

Enable the local user account.

-FullName <String>

Updated Full Name of the User Account.

-MobilePhone <String>

Updated mobile phone number

-OfficePhone <String>

Updated office phone of the User Account.

-Password <String>

New password for the user account. Passwords must be at least 8 characters.

-Roles <Array>

Aliases [-r, -role] The role(s) to assign to the Directroy Group, in System.Collections.ArrayList format. Accepted values are noted within the ApplianceRoles property of the HPOneView.Appliance.Connection object stored in the $Global:ConnectedSessions variable.

Example: $roles = "Server administrator","Network administrator"

-ScopePermissions <Array>

Array collection of Hashtable<Role; Scope>. Will overwrite existing scope to role mappings.

Example: -ScopePermissions @{Role = 'Network administrator'; Scope = (Get-HPOVScope -Name CorpNetAdmins -ErrorAction Stop) }

-UserName <String>

The name or object of the user account to be updated.

-UserObject <Object>

The object of the user account to be updated.

<CommonParameters>

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

HPOneView.Appliance.User [System.Management.Automation.PSCustomObject]

HPE OneView User Account object created on an appliance

HPOneView.Appliance.User [System.Management.Automation.PSCustomObject]

If successful, returns a user resource

 -------------------------- EXAMPLE 1 --------------------------

Set-HPOVUser -username Sally -roles @("server administrator","network administrator")

Update the user account 'Sally' with new roles.

 -------------------------- EXAMPLE 2 --------------------------

Set-HPOVUser -username Sally -password NewP@ssw0rd

Update the user account 'Sally' with a new password.

 -------------------------- EXAMPLE 3 --------------------------

$Scope = Get-HPOVScope -Name Scope1 -ErrorAction Stop
Get-HPOVUser -Username Sally | Set-HPOVUser -Roles 'Server administrator' -ScopePermissions @{Role = 'Network administrator'; Scope = $Scope }

Modify the user account with the new role and scope permissions.

• Get-HPOVUser
• New-HPOVUser
• Remove-HPOVUser
• Set-HPOVUserPassword
• Set-HPOVUserRole
• Show-HPOVUserSession