Set-NAVServerPermission

  • Reference
Module:
Microsoft.Dynamics.Nav.Management

Changes the values for an existing permission set.

Syntax

Set-NAVServerPermission
   -PermissionSetId <String>
   -ObjectType <ObjectType>
   -ObjectId <Int32>
   [-SecurityFilter <String>]
   [-Read <PermissionOption>]
   [-Insert <PermissionOption>]
   [-Modify <PermissionOption>]
   [-Delete <PermissionOption>]
   [-Execute <PermissionOption>]
   [-ServerInstance] <String>
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use the Set-NAVServerPermission cmdlet to change the permissions that are granted by an existing permission set.

Examples

EXAMPLE 1

Set-NAVServerPermission BC -PermissionSetId BASIC -ObjectType Page -ObjectId 21 -Read Indirect

This example updates the Read permission for the specified page object to Indirect for the BASIC permission set.

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

-Delete

Specifies the delete permission for the object. You can use either a string value (such as No) or a numeric value (such as 0).

No = 0

Yes = 1

Indirect = 2

Type:PermissionOption
Accepted values:No, Yes, Indirect
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Execute

Specifies the execute permission for the object. You can use either a string value (such as No) or a numeric value (such as 0).

No = 0

Yes = 1

Indirect = 2

Type:PermissionOption
Accepted values:No, Yes, Indirect
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

-Insert

Specifies the insert permission for the object. You can use either a string value (such as No) or a numeric value (such as 0).

No = 0

Yes = 1

Indirect = 2

Type:PermissionOption
Accepted values:No, Yes, Indirect
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Modify

Specifies the modify permission for the object. You can use either a string value (such as No) or a numeric value (such as 0).

No = 0

Yes = 1

Indirect = 2

Type:PermissionOption
Accepted values:No, Yes, Indirect
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Specifies the ID of the object that the permission applies to.

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

-ObjectType

Specifies the type of the object the permission applies to. You can use either a string value (such as TableData) or a numeric value (such as 0).

TableData = 0

Table = 1

Form = 2

Report = 3

Dataport = 4

CodeUnit = 5

XmlPort = 6

MenuSuite = 7

Page = 8

Query = 9

System = 10

FieldNumber = 11

Type:ObjectType
Accepted values:TableData, Table, Form, Report, Dataport, CodeUnit, XmlPort, MenuSuite, Page, Query, System, FieldNumber, LimitedUsageTableData, TablePage, PageExtension, TableExtension, Enum, EnumExtension
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PermissionSetId

The ID of the permission set that you are updating, such as BASIC or SUPER.

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

-Read

Specifies the read permission for the object. You can use either a string value (such as No) or a numeric value (such as 0).

No = 0

Yes = 1

Indirect = 2

Type:PermissionOption
Accepted values:No, Yes, Indirect
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityFilter

Specifies a security filter for the permission.

Type:String
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