Updates the name, description, or priority of an existing smart client profile.
Set-VmsClientProfile cmdlet updates the name, description, or priority of
an existing smart client profile. The priority of a client profile is not available
as a property on the
ClientProfile object, but the order in which the profiles
are returned by
Get-VmsClientProfile should reflect the same order and priority
shown in Management Client.
If a profile should have the highest, most "important" priority and be assigned first when a user is a member of multiple roles with different smart client profiles, that profile should be given a low priority number with "1" as the lowest value. By assigning a priority of "1" to a client profile, that profile should move to the top of the smart client profile list in Management Client.
- Requires VMS connection and will attempt to connect automatically
- Requires VMS version 21.2
- Requires VMS feature "SmartClientProfiles"
Randomly re-prioritize smart client profiles.
Import one or more profiles from a local
clientprofile.json file. If more than
one client profile are defined in the file, they will all be imported and they
will all be given the same description. However, only the last profile in the
file will have priority "1". Each time a profile is given a new priority, it is
moved up or down the list as needed.
Specifies a smart client profile. The value can be either a ClientProfile object as returned by Get-VmsClientProfile, or it can be the name of an existing client profile.
Specifies an optional description.
Specifies a new, unique name for the smart client profile.
Specifies that the updated client profile should be returned to the pipeline.
Specifies a new priority from 1 to
Prompts you for confirmation before running the cmdlet.
Shows what would happen if the cmdlet runs. The cmdlet is not run.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.