Share via

Set-NAVServerPermissionSet

  • Reference
Module:
Microsoft.BusinessCentral.Management

Changes the Name field of a Business Central permission set.

Syntax

Set-NAVServerPermissionSet
   -PermissionSetId <String>
   -PermissionSetName <String>
   [-ServerInstance] <String>
   [-Force]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Permission sets have an ID (or Role ID) field and a descriptive Name field. Use the Set-NAVServerPermissionSet cmdlet to change the Name field of a specific permission set. You use the ID field to identify the permission set that you want to rename. The cmdlet does not change the ID.

Examples

EXAMPLE 1

Set-NAVServerPermissionSet BC -PermissionSetId MySet -PermissionSetName NewName

This example renames the permission set that has the ID 'MySet' to 'NewName'.

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PermissionSetId

Specifies the ID of the permission set that you want to rename.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PermissionSetName

Specifies the new name for the permission set.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ProgressAction

A common PowerShell parameter that determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider. Learn more.

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerInstance

Specifies the name of a Business Central Server instance, for example, BC or myinstance. You can specify either the full name of an instance, such as MicrosoftDynamicsNavServer$myinstance or the short name such as myinstance.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

You can pipe a string that contains a Business Central Server instance name to the cmdlet.

Outputs

None