PowerShell Logo Small

New-NfsNetgroup



This is the built-in help made by Microsoft for the command 'New-NfsNetgroup', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 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
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<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

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.