PowerShell Logo Small

New-NfsNetgroup



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

Creates a netgroup.

SYNTAX


New-NfsNetgroup [-NetGroupName] <String> [[-AddMember] <String[]>] [[-LdapServer] <String>] [[-LdapNamingContext] <String>] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-NfsNetgroup cmdlet creates a netgroup. It can also add members to the new netgroup. The netgroup provides access to shares that Network File System (NFS) server
exports.


You can create a netgroup in Active Directory Domain Services (ADDS), on an Active Directory Lightweight Directory Services (AD LDS) server, or on Lightweight Directory
Access Protocol (LDAP) servers. If you do not specify a netgroup store, New-NfsNetgroup creates a netgroup in the netgroup store that is configured on the local computer.


The cmdlet creates the netgroup as a relative distinguished name in an LDAP naming context (directory partition). For example, if the specified naming context is
DN=netgroups,CN=Contoso,CN=com", the distinguished name of the netgroup Contoso-PrintServices is "DN= Contoso-PrintServices ,DN=netgroups,CN=Contoso,CN=com".


You can group NFS client computers logically into netgroups to easily manage mount permissions for all the computers that are in the group. Because netgroups are a
server-side setting, New-NfsNetgroup is not available on client operating systems.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?linkid=287519
Get-NfsNetgroup
Remove-NfsNetgroup
Set-NfsNetgroup

REMARKS

<

Examples


Example 1: Create a netgroup and add a member

PS C:\> New-NfsNetgroup -NetGroupName "Contoso-PrintServices -AddMember "Contoso-PS02" -LdapInstanceName "Contoso.com" -LdapNamingContext
"CN=MappedIdentity,DC=Contoso,DC=com"



This command creates a netgroup that is named Contoso-PrintServices and adds one member that is named Contoso-PS02.




Example 2: Create a netgroup and add multiple members

PS C:\> New-NfsNetgroup -NetGroupName "AppServers" -AddMember "Contoso-APPS-11","Contoso-APPS-12" -LdapServer "Contoso.com" -LdapNamingContext "CN=netgroup,DC=Contoso,DC=com"



This command creates a netgroup that is named AppServers and adds two members that are named Contoso-APPS-11 and Contoso-APPS-12.