Share via

New-NAVServerPermission

  • Reference
Module:
Microsoft.BusinessCentral.Management

Adds a permission to a permission set.

Syntax

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

Description

Use the New-NAVServerPermission cmdlet to add a permission to a 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 whether the permission includes 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 whether the permission includes 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 whether the permission includes 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 whether the permission includes 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 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, Profile, ProfileExtension, PermissionSet, PermissionSetExtension, ReportExtension, ExternalBusinessEvent, DynamicQuery, MovedObjectManifest
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

-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

-Read

Specifies whether the permission includes 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

Notes

Because cmdlets do not execute application code, if there is any logic on application objects that are associated with creating or modifying permissions from the client, be aware that the logic will not be executed when you run the cmdlet.