Get-NAVServerUserPermissionSet
Get-NAVServerUserPermissionSet
Returns permission set information for Microsoft Dynamics NAV users.
Syntax
Parameter Set: __AllParameterSets
Get-NAVServerUserPermissionSet [-ServerInstance] <String> [-AsXml] [-CompanyName <String> ] [-PermissionSetId <String> ] [-Sid <String> ] [-UserName <String> ] [-WindowsAccount <String> ] [ <CommonParameters>]
Detailed Description
Use the Get-NAVServerUserPermissionSet cmdlet to return permission set information for Microsoft Dynamics NAV users. Specifically, the cmdlet returns the following information for each relevant user:
User Security ID
PermissionSet
Company Name
User Name
Permission Set Name
You can also use any one of these values, or any combination of these values, to filter the return.
Parameters
-AsXml
Formats cmdlet output as an XML node.
By default, the cmdlet will output the result in a readable text format. When this parameter is applied, the cmdlet outputs the result as an XML node or document.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-CompanyName<String>
The name of a company in the Microsoft Dynamics NAV database. If this argument is not included in the cmdlet, users in the default company are returned.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PermissionSetId<String>
The ID of a permission set, such as RES-JOURNAL or SUPER.
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. 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.
System.Data.DataTable
Returns the permission set information as a table.
System.Xml.XmlElement
If you use the AsXml parameter, then the cmdlet returns the permission set information as an XML element.
Examples
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
This example returns permission sets for all current Microsoft Dynamics NAV users.
C:\PS>Get-NAVServerUserPermissionSet DynamicsNav70
-------------------------- EXAMPLE 2 --------------------------
Description
-----------
This example returns information for a specific user, filtered by the user's Windows account name.
C:\PS>Get-NAVServerUserPermissionSet DynamicsNav70 -WindowsAccount cronus\chris
User Security ID : b5013678-36e5-4469-8f07-dcc453fed66f
PermissionSet ID : SUPER
Company Name : CRONUS International Ltd
User Name : cronuschris
PermissionSet Name : This role has all permissions.