PowerShell Logo Small

Get-NfsMappedIdentity



This is the built-in help made by Microsoft for the command 'Get-NfsMappedIdentity', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets an NFS mapped identity.

SYNTAX


Get-NfsMappedIdentity [-AccountName <String>] [-GroupIdentifier <Int32>] [-MappingStore <MappingStoreType>] [-UserIdentifier <Int32>] -AccountType <AccountType>
[<CommonParameters>]
Get-NfsMappedIdentity [-AccountName <String>] [-GroupIdentifier <Int32>] [-LdapNamingContext <String>] [-Server <String>] [-UserIdentifier <Int32>] -AccountType
<AccountType> -MappingStore <MappingStoreType> [<CommonParameters>]
Get-NfsMappedIdentity [-AccountName <String>] [-GroupIdentifier <Int32>] [-MapFilesPath <String>] [-UserIdentifier <Int32>] -AccountType <AccountType> -MappingStore
<MappingStoreType> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-NfsMappedIdentity cmdlet gets a Network File System (NFS) mapped identity.


A mapped identity associates a Windows user account or group account to a UNIX user account or group account. A user ID (UID) or group ID (GID) identifies a UNIX account
namespace. These elements are associated with the corresponding elements of a Windows account namespace: a user name or a group name. By using a mapped identity, a user who
is logged on to a UNIX domain can access shared resources in a Windows domain without having to log on to the Windows domain.


For more information about NFS, see Network File System. For more information about NFS account mapping, see NFS Account Mapping Guide and Identity Management for UNIX.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?linkid=287515
RFC-2307
Get-NfsMappedIdentity
New-NfsMappedIdentity
Remove-NfsMappedIdentity
Resolve-NfsMappedIdentity
Set-NfsMappedIdentity
Test-NfsMappedIdentity
Get-NfsMappingStore
Install-NfsMappingStore
Set-NfsMappingStore
Test-NfsMappingStore

REMARKS

<

Examples


Example 1: Get a mapped identity for a user account by using a specified name

PS C:\> Get-NfsMappedIdentity -MappingStore "LDAP" -AccountType "User" -AccountName "RPatel"



This command gets all user account mapped identities from a configured AD LDS or RFC 2307–compliant LDAP store instance. In this example, the command returns PrimaryGroup
and SupplementaryGroups only when the configured mapping store is MapFiles.




Example 2: Get all group account mapped identities from a specific store instance

PS C:\> Get-NfsMappedIdentity -MappingStore "LDAP" -AccountType "Group" –GroupName "Administrators"



This command gets all mapped identities in the Administrator group from a configured AD LDS or RFC 2307–compliant LDAP store instance.




Example 3: Get a mapped identity for a group account by using a specified Id

PS C:\> Get-NfsMappedIdentity -MappingStore "LDAP" -AccountType "Group" -GroupIdentifier "GID99"



This command gets a mapped identity for the group account that has the GID 99, from a configured AD LDS or RFC 2307–compliant LDAP store instance.




Example 4: Get all user account mapped identities from a specific mapping store

C:\PS> Get-NfsMappedIdentity -MappingStore "LDAP" -AccountType "User"



This command gets all user account mapped identities from a configured AD LDS or RFC 2307–compliant LDAP store instance. PrimaryGroup and SupplementaryGroups are returned
only when the configured mapping store is MapFiles.




Example 5: Get all user account mapped identities from a mapping store that is specified in the NFS Server configuration settings

PS C:\>Get-NfsMappedIdentity -AccountType "User"



This command gets all user account mapped identities from a mapping store that is specified in the NFS server configuration settings.