Set-VBRNasFilerNFSServer

Short Description

Modifies settings of NFS shared folders located on an enterprise NAS system and added to the inventory.

Applies to

Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides parameter sets that allow you to:

  • Specify a cache repository to use for an NFS file share located on an enterprise NAS system.

Set-VBRNasFilerNFSServer -Server <VBRSANNASNFSServer> [-CacheRepository <CBackupRepository>] [-MetaMigrationType <VBRNASBackupMetaMigrationType>] [-BackupIOControlLevel <VBRNASBackupIOControlLevel>] [-Encoding <VBRNASEncoding>]  [<CommonParameters>]

  • Specify that an NFS file share located on an enterprise NAS system will inherit settings of the cache repository from NAS system settings.

Set-VBRNasFilerNFSServer -Server <VBRSANNASNFSServer> [-MetaMigrationType <VBRNASBackupMetaMigrationType>] [-InheritSettingsFromFiler] [-Encoding <VBRNASEncoding>]  [<CommonParameters>]

Detailed Description

This cmdlet modifies settings of NFS shared folders located on an enterprise NAS system and added to the inventory.

You can either specify the cache repository manually or make the file share to inherit cache repository settings from the enterprise NAS system.

Note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameters values with new values. The parameters that you omit will remain unchanged.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Server

Specifies an NFS file share. The cmdlet will modify settings for this file share.

Accepts the VBRSANNASNFSServer (VBRNASServer) object. To get this object, run the Get-VBRUnstructuredServer cmdlet.

True

Named

True (ByValue, ByPropertyName)

CacheRepository

Specifies a cache repository. The cmdlet will set this repository as a cache repository for the NFS file share.

Accepts the CBackupRepository object. To get this object, run the Get-VBRBackupRepository cmdlet.

False

Named

False

MetaMigrationType

Specifies how the cmdlet will migrate metadata. You can use one of the following options:

  • CheckExistence — use this option to check that metadata is available on the current cache repository.
  • CopyMetaFromCache — use this option to migrate metadata from source cache repository to a new cache repository.
    Note: If metadata in a source cache repository is corrupted, the cmdlet will copy data from the archive repository.
  • DownloadMetaFromArchive — use this option to migrate metadata from archive repository or from replica metadata in archive repository.

VBRNASBackupMetaMigrationType

False

Named

False

InheritSettingsFromFiler

Defines that the NFS file share will inherit settings of the enterprise NAS system. If you provide this parameter, the cmdlet will inherit cache settings, throttling settings and credentials.

Note: You must provide the MetaMigrationType to inherit cache repository settings.

SwitchParameter

True

Named

False

Encoding

Specifies encoding for the NFS file share. You can specify one of the following values:

  • utf
  • ansi

VBRNASEncoding

False

Named

False

BackupIOControlLevel

Specifies a speed that Veeam Backup & Replication will use to read data from the file server. You can specify either of the following speed:

  • Lowest
  • Low
  • Medium
  • High
  • Highest

VBRNASBackupIOControlLevel

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBRNASServer object that defines settings of the NFS file share located on the enterprise NAS system.

Examples

Set-VBRNasFilerNFSServerExample 1. Setting Cache Repository of SMB Share Manually

The following request modifies NFS share: a cache repository is specified manually, ANSI encoding will be used for the share.

$isilonhost = Get-VBRIsilonHost -Name 'HostName'

$volume = Get-VBRIsilonVolume -Name 'NFS Share' -Host $isilonhost

$isi = Get-VBRUnstructuredServer -SANEntity $volume

$cacherepo = Get-VBRBackupRepository -Name 'Cache repository 1'

Set-VBRNasFilerNFSServer -Server $isi -CacheRepository $cacherepo -Encoding ansi

Perform the following steps:

  1. Run the Get-VBRIsilonHost cmdlet. Specify the Name parameter value. Save the result to the $isilonhost variable.
  2. Run the Get-VBRIsilonVolume cmdlet. Specify the Name parameter value. Set the $isilonhost variable as the Host parameter value. Save the result to the $volume variable.
  3. Run the Get-VBRUnstructuredServer cmdlet. Set the $volume variable as the SANEntity parameter value. Save the result to the $volume variable.
  4. Run the Get-VBRBackupRepository cmdlet. Specify the Name parameter value. Save the result to the $cacherepo variable.
  5. Run the Set-VBRNasFilerNFSServer cmdlet. Specify the following settings:
  • Set the $isi variable as the Server parameter value.
  • Set the $cacherepo variable as the CacheRepository parameter value.
  • Specify the Encodng parameter value.

Set-VBRNasFilerNFSServerExample 2. Setting Cache Repository Settings Inherited from NAS System for NFS Share

The following request modifies NFS share: a cache repository settings are inherited from the enterprise NAS system on which the share is located, UTF encoding will be used for the share.

$isilonhost = Get-VBRIsilonHost -Name 'HostName'

$volume = Get-VBRIsilonVolume -Name 'NFS Share' -Host $isilonhost

$isi = Get-VBRUnstructuredServer -SANEntity $volume

Set-VBRNasFilerNFSServer -Server $isi -InheritSettingsFromFiler -Encoding utf

Perform the following steps:

  1. Run the Get-VBRIsilonHost cmdlet. Specify the Name parameter value. Save the result to the $isilonhost variable.
  2. Run the Get-VBRIsilonVolume cmdlet. Specify the Name parameter value. Set the $isilonhost variable as the Host parameter value. Save the result to the $volume variable.
  3. Run the Get-VBRUnstructuredServer cmdlet. Set the $volume variable as the SANEntity parameter value. Save the result to the $volume variable.
  4. Run the Set-VBRNasFilerNFSServer cmdlet. Specify the following settings:
  • Set the $isi variable as the Server parameter value.
  • Provide the InheritSettingsFromFiler parameter.
  • Specify the Encodng parameter value.

Related Commands