New-NAVServerUserPermissionSet

New-NAVServerUserPermissionSet

Assigns a permission set to a Microsoft Dynamics NAV user.

Syntax

Parameter Set: __AllParameterSets
New-NAVServerUserPermissionSet [-ServerInstance] <String> [-CompanyName <String> ] [-PermissionSetId <String> ] [-Sid <String> ] [-UserName <String> ] [-WindowsAccount <String> ] [ <CommonParameters>]

Detailed Description

Use the New-NAVServerUserPermissionSet cmdlet to assign a permission set to a Microsoft Dynamics NAV user. Use the UserName, Sid, or WindowsAccount parameter to identify the user. Use the PermissionSetID parameter to identify the permission set.

Parameters

-CompanyName<String>

The name of the Microsoft Dynamics NAV company on which to apply the permission set.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PermissionSetId<String>

The ID of an existing permission set in the Microsoft Dynamics NAV database, such as SUPER, CASHFLOW, or BASIC.

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 DynamicsNAV70. 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

-Sid<String>

A security identifier (SID) for a Microsoft Dynamics NAV user. The SID is a unique value that identifies a Windows user account.

You can use the Sid, UserName, or WindowsAccount parameters to identify the user. If you use the Sid parameter, then do not set the UserName or WindowsAccount parameters.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-UserName<String>

Specifies the user name of the Microsoft Dynamics NAV user to assign the permission set to. The user name is defined by the User Name field in a user's account in Microsoft Dynamics NAV.

You can use the UserName, WindowsAccount, or Sid parameters to identify the user. If you use the Username parameter, then you cannot use the WindowsAccount or Sid parameters.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WindowsAccount<String>

Specifies the Windows user name of a Microsoft Dynamics NAV user to assign the permission set to. The value has the domain\username format.

You can use the WindowsAccount, UserName, or Sid parameters to identify the user. If you use the WindowsAccount parameter, then you cannot use the UserName or Sid parameters.

Aliases

none

Required?

false

Position?

named

Default Value

none

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 the BASIC permission set for Windows user Cronus\Chris.

C:\PS>New-NAVServerUserPermissionSet DynamicsNAV70 –WindowsAccount Cronus\Chris -PermissionSetId BASIC