Set-NfsNetgroupStore

Set-NfsNetgroupStore

Modifies netgroup configuration settings.

Syntax

Parameter Set: InputObject (cdxml)
Set-NfsNetgroupStore [-AsJob] [-CimSession <CimSession[]> ] [-InputObject <CimInstance[]> ] [-LDAPNamingContext <String> ] [-LdapServer <String> ] [-NetgroupStoreType <String> ] [-NisDomain <String> ] [-NisServer <String> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Set-NfsNetgroupStore cmdlet modifies configuration settings that a Network File System (NFS) Server uses to obtain netgroups from a specified netgroup store.

An NFS server can get netgroups from Network Information Service (NIS) or RFC-2307-compliant Lightweight Directory Access Protocol (LDAP)–based stores, such as Active Directory Domain Services (AD DS) or Active Directory Lightweight Directory Services (AD LDS).

Parameters

-AsJob

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CimSession<CimSession[]>

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InputObject<CimInstance[]>

Gets an array of Common Information Model (CIM) instances from a CIM server.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-LDAPNamingContext<String>

Specifies an LDAP naming context that the NFS server uses when it performs LDAP queries to obtain netgroup information.

The NFS server uses this parameter only if the NetgroupSourceType parameter is set to LDAP. If NetgroupSourceType is set to NIS or None, the NFS server ignores the value set for this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-LdapServer<String>

Specifies an LDAP server name or an Active Directory domain name that stores netgroup information.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NetgroupStoreType<String>

Specifies the type of netgroup store. Valid values for this are: LDAP, NIS, or None.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NisDomain<String>

Specifies the NIS domain of the NIS server where information about netgroups is stored.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NisServer<String>

Specifies the host name of the NIS server where information about netgroups is stored.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ThrottleLimit<Int32>

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Required?

false

Position?

named

Default Value

false

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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Management.Infrastructure.CimInstance#root/Microsoft/Windows/NFS/MSFT_NfsNetgroupStore

Examples

Example 1: Configure an NFS server to get netgroups from an LDAP store

This command configures an NFS server to get netgroups from an LDAP store that is named Contoso.com.

PS C:\> Set-NfsNetgroupStore -NetgroupSourceType "LDAP" -LdapServer "Contoso.com"

Example 2: Configure an NFS server to get netgroups from an NIS store

This command configures an NFS server to get netgroups from an NIS store that is named NIS.Contoso.com.

PS C:\> Set-NfsNetgroupStore -NetgroupSourceType "NIS" -NisServer "NIS.Contoso.com"

Get-NfsNetgroupStore

Set-NfsMappingStore

RFC-2307