Remove-NAVServerUser

Remove-NAVServerUser

Deletes a Microsoft Dynamics NAV user.

Syntax

Parameter Set: __AllParameterSets
Remove-NAVServerUser [-ServerInstance] <String> [-Force] [-Sid <String> ] [-UserName <String> ] [-WindowsAccount <String> ] [ <CommonParameters>]

Detailed Description

Use the Remove-NAVServerUser cmdlet to delete a Microsoft Dynamics NAV user. Use either the Sid or the WindowAccount parameter to identify the user.

Parameters

-Force

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 the Microsoft Dynamics NAV user to delete. 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 delete. 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 the Microsoft Dynamics NAV user to delete. 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 deletes a Microsoft Dynamics NAV user. The user is identified by the security identifier.

C:\PS>Remove-NAVServerUser MicrosoftDynamicsNavServer -Sid S-1-5-20

-------------------------- EXAMPLE 2 --------------------------

Description

-----------

This example deletes a Microsoft Dynamics NAV. The user is identified by the Windows account user name.

C:\PS>Remove-NAVServerUser DynamicsNAV70 –WindowsAccount cronus\chris

-------------------------- EXAMPLE 3 --------------------------

Description

-----------

This example deletes a Microsoft Dynamics NAV. The user is identified by the user name in Microsoft Dynamics NAV.

C:\PS>Remove-NAVServerUser MicrosoftDynamicsNavServer -UserName USER2