Remove-NAVServerUserPermissionSet

Remove-NAVServerUserPermissionSet

Removes a permission set from the list of permission sets that are assigned to a Microsoft Dynamics NAV user.

Syntax

Parameter Set: __AllParameterSets
Remove-NAVServerUserPermissionSet [-ServerInstance] <String> -PermissionSetId <String> [-CompanyName <String> ] [-Force] [-Tenant <TenantId> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject
Remove-NAVServerUserPermissionSet -InputObject <DataRow> -PermissionSetId <String> [-CompanyName <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Sid
Remove-NAVServerUserPermissionSet -PermissionSetId <String> -Sid <String> [-CompanyName <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: UserName
Remove-NAVServerUserPermissionSet -PermissionSetId <String> -UserName <String> [-CompanyName <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: WindowsAccount
Remove-NAVServerUserPermissionSet -PermissionSetId <String> -WindowsAccount <String> [-CompanyName <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

Use the Remove-NAVServerUserPermissionSet cmdlet to remove a permission set that is assigned to a Microsoft Dynamics NAV user. You can use the Get-NAVServerUserPermissionSet cmdlet to determine which permission sets are currently assigned to a particular user.

Parameters

-CompanyName<String>

Specifies the name of a company in the Microsoft Dynamics NAV database. The specified user permission sets are removed for that company only.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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

-InputObject<DataRow>

Specifies the DataRow object that identifies the user to remove the permission set from. You can pass this object from the Get-NAVServerUserPermissionSet cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-PermissionSetId<String>

Specifies the ID of a permission set, which is a string such as RES-JOURNAL or SUPER.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ServerInstance<String>

Specifies the name of a Microsoft Dynamics NAV Server instance. The default instance name is DynamicsNAV90. 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) of the 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 the ID of the tenant that is mounted of the Microsoft Dynamics NAV Server instance to which the user belongs.

You can omit the Tenant parameter only if the Microsoft Dynamics NAV Server instance is not configured to run multiple tenants.

Aliases

Id

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. 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 the Microsoft Dynamics NAV user. The value has the domain\username format.

You can use either 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.

  • System.Data.DataRow

    You can pass this object from the Get-NAVServerUserPermissionSet cmdlet to remove a permission set from a user.

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 removes the built-in account (Network Service) from the AVOCADO permission set.

C:\PS>Remove-NAVServerUserPermissionSet DynamicsNAV90 -Sid S-1-5-20 -PermissionSetId AVOCADO