PowerShell Logo Small

Set-NfsMappedIdentity



This is the built-in help made by Microsoft for the command 'Set-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

Modifies a mapped identity.

SYNTAX


Set-NfsMappedIdentity [-GroupIdentifier <Int32>] [-LdapNamingContext <String>] [-MappingStore <MappingStoreType>] [-Server <String>] [-UserIdentifier <Int32>] -UserName
<String> [-Confirm] [-WhatIf] [<CommonParameters>]
Set-NfsMappedIdentity [-LdapNamingContext <String>] [-MappingStore <MappingStoreType>] [-Server <String>] -GroupIdentifier <Int32> -GroupName <String> [-Confirm] [-WhatIf]
[<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Set-NfsMappedIdentity cmdlet modifies a mapped identity that is stored in the Network File System (NFS) server mapping store. The cmdlet also updates the group
membership of the Windows user account to match its assigned group identifier (GID).



<

RELATED LINKS

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

REMARKS

<

Examples


Example 1: Modify a mapped identity that is stored in an AD LDS instance

PS C:\> Set-NfsMappedIdentity -MappingStore "LDAP" -GroupName "Administrators" -GroupIdentifier 600



This command modifies a mapped identity that is stored in a configured AD LDS instance and that corresponds to the Windows group account Administrators. The command resets
the associated group identifier to 600.




Example 2: Modify a mapped identity that is stored in an Active Directory domain

PS C:\> Set-NfsMappedIdentity -Store "AD" –Server "Contoso"-UserName "JCool" -UserIdentifier 501 -GroupIdentifier 600



This command modifies a mapped identity that is stored in a specified Active Directory domain and that corresponds to the user account JCool. The command sets the user
identifier to 501 and the group identifier to 600, and it updates the group membership of the user account JCool to make it a member of a group account that has GID 600.




Example 3: Modify a mapped identity that is stored in a configured LDAP store

PS C:\> Set-NfsMappedIdentity -Store "LDAP" -UserName "JCool" -UserIdentifier 501 -GroupIdentifier 600 -Server "MyLdapServer:389" -LdapNamingContext "CN=NFS,DC=NFS"



This command modifies a mapped identity that is stored in the LDAP store on a specified server that is named MyLdapServer and that corresponds to the user account
Contoso\JCool. It sets the user identifier to 501 and the group identifier to 600. The command also adds the user account JCool to GID 600.