Get-NAVServerUser

Get-NAVServerUser

Returns information about all users created in the current Microsoft Dynamics NAV database.

Syntax

Parameter Set: __AllParameterSets
Get-NAVServerUser [-ServerInstance] <String> [-Force] [-Tenant <TenantId> ] [ <CommonParameters>]

Detailed Description

Use the Get-NAVServerUser cmdlet to return information about all users created in the current Microsoft Dynamics NAV database.

The following information is returned for each user:

User Security ID
User Name
Full Name
State
Expiry Date
Windows Security ID
Change Password
License Type
AuthenticationEmail
Password
NameIdentifier
AuthenticationKey
WebServicesKey
WebServicesKeyExpiryDate
ProfileID

For more information about these values, see the Help for the User page in the Microsoft Dynamics NAV Windows client.

Parameters

-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

-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

-Tenant<TenantId>

Specifies the ID of the tenant that the users are stored in, such as Tenant1. This parameter is required unless the specified service 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

<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 and tenant ID, if applicable) to the cmdlet.

Outputs

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

  • System.Data.DataRow

    Returns the user information as a row.

Examples

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

Description

-----------

This example returns information about Microsoft Dynamics NAV users.

C:\PS>Get-NAVServerUser DynamicsNAV71
User Security ID         : b5013678-36e5-4469-8f07-dcc453fed66f
User Name                : MyDomain_x005C_User1
Full Name                : MyDomain_x005C_User1
State                    : Enabled
Expiry Date              : 1/1/0001 12:00:00 AM
Windows Security ID      : S-1-5-21-xxxxxxxxxx-xxxxxxxxx-xxxxxxxxxx-xxxxxxx
Change Password          : False
License Type             : Full User
AuthenticationEmail      : 
Password                 : 
NameIdentifier           : 
AuthenticationKey        : 
WebServicesKey           : 
WebServicesKeyExpiryDate : 1/1/0001 12:00:00 AM
ProfileID                : BOOKKEEPER

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

Description

-----------

This example returns information about Microsoft Dynamics NAV users who belong to the tenant Tenant1 on the Microsoft Dynamics NAV Server instance.

C:\PS>Get-NAVServerUser DynamicsNAV71 -Tenant "Tenant1"
User Security ID         : b5013678-36e5-4469-8f07-dcc453fed66f
User Name                : MyDomain_x005C_User1
Full Name                : MyDomain_x005C_User1
State                    : Enabled
Expiry Date              : 1/1/0001 12:00:00 AM
Windows Security ID      : S-1-5-21-xxxxxxxxxx-xxxxxxxxx-xxxxxxxxxx-xxxxxxx
Change Password          : False
License Type             : Full User
AuthenticationEmail      : 
Password                 : 
NameIdentifier           : 
AuthenticationKey        : 
WebServicesKey           : 
WebServicesKeyExpiryDate : 1/1/0001 12:00:00 AM
ProfileID                : BOOKKEEPER