Set-NfsServerConfiguration

Set-NfsServerConfiguration

Changes configuration settings for an NFS server.

구문

Parameter Set: InputObject (cdxml)
Set-NfsServerConfiguration [-AlwaysOpenByName <Boolean> ] [-AsJob] [-AuthenticationRenewalIntervalSec <UInt32> ] [-CharacterTranslationFile <String> ] [-CimSession <CimSession[]> ] [-ClearMappingCache] [-DirectoryCacheSize <UInt32> ] [-EnableAuthenticationRenewal <Boolean> ] [-EnableNFSV2 <Boolean> ] [-EnableNFSV3 <Boolean> ] [-EnableNFSV4 <Boolean> ] [-GracePeriodSec <UInt32> ] [-HideFilesBeginningInDot <Boolean> ] [-InputObject <CimInstance[]> ] [-LeasePeriodSec <UInt32> ] [-LogActivity <String[]> ] [-MapServerProtocol <String[]> ] [-MountProtocol <String[]> ] [-NetgroupCacheTimeoutSec <UInt32> ] [-Nfsprotocol <String[]> ] [-NisProtocol <String[]> ] [-NlmGracePeriodSec <UInt32> ] [-NlmProtocol <String[]> ] [-NsmProtocol <String[]> ] [-OnlineTimeoutSec <UInt32> ] [-PassThru] [-PortmapProtocol <String[]> ] [-PreserveInheritance <Boolean> ] [-ThrottleLimit <Int32> ] [-UnmappedUserAccount <String> ] [-WorldAccount <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

자세한 설명

The Set-NfsServerConfig cmdlet changes the configuration settings for an existing Network File System (NFS) server.

For some changes to take effect, you must restart Services for NFS. The cmdlet prompts you to restart if necessary.

매개 변수

-AlwaysOpenByName<Boolean>

Specifies whether an NFS server opens files and directories by name, instead of opening by file ID. You can enable this setting for compatibility with filter drivers that intercept requests for opening files and directories by file name, or for applications that rely on directory change notifications to work with NFS shares.

The default value is $False. By default, an NFS server opens files and directories by ID to improve performance.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-AsJob

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-AuthenticationRenewalIntervalSec<UInt32>

Specifies an interval, in seconds, when an NFS server renews authentication.

별칭	없음
필수 여부	false
위치	named
기본값	600
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-CharacterTranslationFile<String>

Specifies a path for a file that an NFS server uses for character translation.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-CimSession<CimSession[]>

원격 세션에서 또는 원격 컴퓨터에서 cmdlet을 실행합니다. New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 컴퓨터 이름이나 세션 개체를 입력합니다. 기본값은 로컬 컴퓨터의 현재 세션입니다.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-ClearMappingCache

Specifies whether to clear the mapping and netgroup cache of an NFS server.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-DirectoryCacheSize<UInt32>

Specifies the size of the directory cache, in kilobytes. This value is a multiple of 4.

별칭	없음
필수 여부	false
위치	named
기본값	128
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-EnableAuthenticationRenewal<Boolean>

Specifies whether an NFS server renews authentication when cached credentials expire.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-EnableNFSV2<Boolean>

Specifies whether an NFS server can export shares via the NFS v2 protocol.

별칭	없음
필수 여부	false
위치	named
기본값	3
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-EnableNFSV3<Boolean>

Specifies whether an NFS server can export shares via the NFS v3 protocol.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-EnableNFSV4<Boolean>

Specifies whether an NFS server can export shares via the NFS v4.1 protocol.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-GracePeriodSec<UInt32>

Specifies a grace period, in seconds, for an NFS server. During this period, clients can reclaim file locks. The value must be at least twice the value specified in the LeasePeriodSec parameter.

The grace period applies to clients connected via the NFS v4.1 protocol.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-HideFilesBeginningInDot<Boolean>

Specifies whether an NFS server creates files that have names that begin with a dot (.) as hidden files.

별칭	없음
필수 여부	false
위치	named
기본값	0
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-InputObject<CimInstance[]>

이 cmdlet에 대한 입력을 지정합니다. 이 매개 변수를 사용하거나 입력을 이 cmdlet으로 파이프할 수 있습니다.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	True (ByValue)
와일드카드 문자 허용 여부	false

-LeasePeriodSec<UInt32>

Specifies a lease period, in seconds, for an NFS server. The minimum value is 5. The maximum value is 300.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-LogActivity<String[]>

Specifies the activities that an NFS server logs for audit purposes. 이 매개 변수에 허용되는 값은 다음과 같습니다.

-- Mount
-- Unmount
-- Read
-- Write
-- Create
-- Delete
-- Lock
-- Unlock
-- All
-- None

You can specify multiple values. Specify All to log all activities or None to log none of these activities.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-MapServerProtocol<String[]>

Specifies one or more preferred underlying transport protocols that an NFS server uses for the User Name Mapping server (MAPSVR) protocol. You must specify at least one of these two values: Tcp and Udp.

별칭	없음
필수 여부	false
위치	named
기본값	3
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-MountProtocol<String[]>

Specifies one or more preferred underlying transport protocols that an NFS server uses for the Mount protocol. You must specify at least one of these two values: Tcp and Udp.

별칭	없음
필수 여부	false
위치	named
기본값	3
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-NetgroupCacheTimeoutSec<UInt32>

Specifies a time-out period, in seconds, for an NFS server. An NFS server enforces this time-out on entries in its netgroup cache.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Nfsprotocol<String[]>

Specifies one or more preferred underlying transport protocols that an NFS server uses for the NFS protocol. You must specify at least one of these two values: Tcp and Udp.

별칭	없음
필수 여부	false
위치	named
기본값	3
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-NisProtocol<String[]>

Specifies one or more preferred underlying transport protocols that an NFS server uses for the Network Information System (NIS) protocol. You must specify at least one of these two values: Tcp and Udp.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-NlmGracePeriodSec<UInt32>

Specifies a grace period, in seconds, that an NFS server enforces for the Network Lock Manager (NLM) protocol. The default value is 45.

별칭	없음
필수 여부	false
위치	named
기본값	45
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-NlmProtocol<String[]>

Specifies one or more preferred underlying transport protocols that an NFS server uses for the NLM protocol. You must specify at least one of these two values: Tcp and Udp.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-NsmProtocol<String[]>

Specifies one or more preferred underlying transport protocols that an NFS server uses for the Network Status Manager (NSM) protocol. You must specify at least one of these two values: Tcp and Udp.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-OnlineTimeoutSec<UInt32>

Specifies a time-out value, in seconds, for an NFS server. An NFS server waits for this length of time for a resource to come online before it processes an incoming request.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-PassThru

작업하고 있는 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-PortmapProtocol<String[]>

Specifies one or more preferred underlying transport protocols that an NFS server uses for the Portmap protocol. You must specify at least one of these two values: Tcp and Udp.

별칭	없음
필수 여부	false
위치	named
기본값	3
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-PreserveInheritance<Boolean>

Specifies whether an NFS server creates inheritable access control entries (ACEs). These ACEs apply to newly created files and folders on NFS shares. The default value is $False for non-inheritable ACEs.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-ThrottleLimit<Int32>

이 cmdlet을 실행하도록 설정할 수 있는 최대 동시 작업 수를 지정합니다. 이 매개 변수가 생략되거나 값 0이 입력되면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 제한 한도를 계산합니다. 제한 한도는 현재 cmdlet에만 적용되며 세션이나 컴퓨터에는 적용되지 않습니다.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-UnmappedUserAccount<String>

Specifies the Windows account that an NFS server uses to represent users who have no mapping configured in the mapping store. By default, an NFS server uses NT AUTHORITY\Anonymous.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-WorldAccount<String>

Specifies the Windows account that an NFS server uses to represent World/Other permissions on files when it uses AUTH_UNIX security. By default, the NFS server uses the BUILTIN\Everyone account.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

필수 여부	false
위치	named
기본값	false
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

필수 여부	false
위치	named
기본값	false
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

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

예제

Example 1: Set a grace period on a local NFS server

This command sets the grace period for the NLM protocol to 45 seconds and sets the grace period for NFS v4.1 to 240 seconds on a local NFS server.

PS C:\> Set-NfsServerConfiguration -NlmGracePeriodSec 45 -GracePeriodSec 240

Example 2: Set NFS versions on a local NFS server

This command disables versions 2 and 3 of the NFS protocol and enables NFS v4.1 on a local NFS server.

PS C:\> Set-NfsServerConfiguration -EnableNfsv2 $false -EnableNfsv4 $true -EnableNfsv3 $true

관련 항목

Get-NfsServerConfiguration