Push-OVAppliancePermission

Syntax

Push-OVAppliancePermission
    [-SetActivePermissions] <Object>
    [-ApplianceConnection <Array>]
    [<CommonParameters>]

Description

Upon successful login, the caller can change their active permissions, and operate in a less priviledge mode at anytime. The Push-OVAppliancePermission Cmdlet will accept a single or collection of [HPEOneView.Appliance.ConnectionPermission] objects. A new SessionID token will be stored within the ApplianceConnection, and the ConnectionPermissions within the ActivePermissions property that were not provided will have their State set to "false".

Examples

Example 1

$ConnectedSessions[0].ActivePermissions

RoleName              ScopeName     Active
--------              ---------     ------
Network administrator Site A Admins True
Server administrator  AllResources  True

$NewPermissions = $ConnectedSessions[0].ActivePermissions | ? RoleName -match "Network"
Push-OVAppliancePermission -SetActivePermissions $NewPermissions

Change active permissions by filtering for a specific Role.

Example 2

$ConnectedSessions[0].ActivePermissions

RoleName              ScopeName     Active
--------              ---------     ------
Network administrator Site A Admins True
Server administrator  AllResources  True
Server administrator  AllResources  True

$NewPermissions = $ConnectedSessions[0].ActivePermissions | ? ScopeName -match "Site A Admins"
Push-OVAppliancePermission -SetActivePermissions $NewPermissions

Change active permissions by filtering for a specific Scope.

Parameters

-SetActivePermissions <Object>

One or more [HPEOneView.Appliance.ConnectionPermission] objects from an [HPEOneView.Appliance.Connection] ActivePermissions property.

Aliases	None
Required?	True
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-ApplianceConnection <Array>

Specify one or more [HPEOneView.Appliance.Connection] object(s) or Name property value(s).

Aliases	Appliance
Required?	False
Position?	Named
Default value	(${Global:ConnectedSessions} \| ? Default)
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 (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

None. You cannot pipe objects to this Cmdlet.

Return Values

HPEOneView.Appliance.ConnectionPermission

One or more appliance connection permissions and their active state.