New-NAVServerPermission

  • Article

New-NAVServerPermission

Adds a permission to a permission set.

Syntax

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

Detailed Description

Use the New-NAVServerPermission cmdlet to add a permission to a permission set.

Parameters

-Delete<PermissionOption>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Execute<PermissionOption>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Force

Skips confirmation prompts when the cmdlet is run.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Insert<PermissionOption>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Modify<PermissionOption>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ObjectId<Int32>

Specifies the ID of the object the permission applies to.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ObjectType<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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PermissionSetId<String>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Read<PermissionOption>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SecurityFilter<String>

Specifies a security filter for the permission.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ServerInstance<String>

Specifies the name of a Microsoft Dynamics NAV Server instance. The default instance name is DynamicsNAV80. You can specify either the full name of an instance (such as MicrosoftDynamicsNavServer$myinstance) or the short name (such as myinstance).

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • System.String

    You can pipe a string that contains a Microsoft Dynamics NAV Server instance name to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

    This cmdlet does not generate any output.

Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

This example adds a new permission for page 21, the Customer card, to the BASIC permission set.

C:\PS>New-NAVServerPermission DynamicsNAV80 -PermissionSetId BASIC -ObjectType Page -ObjectId 21 -Read Yes -Execute Yes -Delete Indirect -Modify Yes -Insert Yes