New-NAVServerUserPermissionSet
New-NAVServerUserPermissionSet
Assigns a permission set to a Microsoft Dynamics NAV user.
Syntax
Parameter Set: __AllParameterSets
New-NAVServerUserPermissionSet [-ServerInstance] <String> -PermissionSetId <String> [-CompanyName <String> ] [-Force] [-Tenant <TenantId> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Sid
New-NAVServerUserPermissionSet -PermissionSetId <String> -Sid <String> [-CompanyName <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: UserName
New-NAVServerUserPermissionSet -PermissionSetId <String> -UserName <String> [-CompanyName <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: WindowsAccount
New-NAVServerUserPermissionSet -PermissionSetId <String> -WindowsAccount <String> [-CompanyName <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
Use the New-NAVServerUserPermissionSet cmdlet to assign a permission set to a Microsoft Dynamics NAV user. Use the UserName, Sid or the 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 |
-Force
Forces the command to run without asking for user confirmation.
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? |
true |
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 DynamicsNAV71. 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>
Specifies 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? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Tenant<TenantId>
Specifies a ID of the tenant that is mounted on the Microsoft Dynamics NAV Server instance. You can omit the Tenant parameter only if the Microsoft Dynamics NAV Server instance is not configured to run multiple tenants.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
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 Windows Account or Sid parameters.
Aliases |
none |
Required? |
true |
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? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
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 the BASIC permission set for Windows user Cronus\Chris.
C:\PS>New-NAVServerUserPermissionSet DynamicsNAV71 –WindowsAccount cronus\chris -PermissionSetId BASIC