Search <book_title>...

Important Update: Cohesity Products Documentation

All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.

Enterprise Vault™ PowerShell Cmdlet

Last Published: 2018-03-28

Product(s): Enterprise Vault (12.3)

Set-EVFSAFolder

Set-EVFSAFolder 更新现有文件夹的指定设置。

Set-EVFSAFolder 由管理单元 Symantec.EnterpriseVault.PowerShell.AdminAPI.dll 提供。

语法

Set-EVFSAFolder [-SiteId <String>] [-FileServer] <String> [-Volume] <String> [-FolderRelativePath] <String> [-Policy <String>] [-IgnoreVolumeRules [<SwitchParameter>]] [-UseVolumePolicy [<SwitchParameter>]] [-DisableArchivingOnFolder [<SwitchParameter>]] [-DisableArchivingOnSubFolders [<SwitchParameter>]] [-IncludeRetentionFolders [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

Set-EVFSAFolder [-SiteId <String>] -Identifier <String> [-Policy <String>] [-IgnoreVolumeRules [<SwitchParameter>]] [-UseVolumePolicy [<SwitchParameter>]] [-DisableArchivingOnFolder [<SwitchParameter>]] [-DisableArchivingOnSubFolders [<SwitchParameter>]] [-IncludeRetentionFolders [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

Set-EVFSAFolder [-SiteId <String>] [-FsaFolder] <FSAFolder> [-Policy <String>] [-IgnoreVolumeRules [<SwitchParameter>]] [-UseVolumePolicy [<SwitchParameter>]] [-DisableArchivingOnFolder [<SwitchParameter>]] [-DisableArchivingOnSubFolders [<SwitchParameter>]] [-IncludeRetentionFolders [<SwitchParameter>]] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

参数

表：Set-EVFSAFolder 参数

参数	说明
-SiteId（必填）	在其中配置文件服务器卷的 Enterprise Vault 站点的 ID。如果省略此参数，Set-EVFSAFolder 会使用正在运行 cmdlet 的 Enterprise Vault 服务器所在站点的 ID。您可以使用 Get-EVSite 获取站点 ID。
-FileServer（必填）	托管该文件夹的文件服务器的完全限定 DNS 名称、UNC 名称、别名或条目 ID。此名称应该与添加文件服务器时使用的名称或管理控制台显示的名称相同。可以使用 Get-EVFSAFileServer 获取文件服务器名称。您可以指定带或不带 \\ 前缀的 UNC 名称，并且您可以指定主机名或别名作为 UNC 名称。参数别名：FileServerDNSName、FileServerName、FileServerId。
-Identifier（必填）	要更新的文件夹的路径，采用以下格式： \\文件服务器名称\卷名称\文件夹相对路径
-FsaFolder（必需）	指定 FSAFolder 对象。请注意，cmdlet 使用指定对象中的 FileServerName、VolumeName 和 FolderName 属性来标识文件夹目标。您还必须指定要更新的参数。
-Volume（必填）	托管此文件夹的文件服务器卷的名称或条目 ID。参数别名：VolumeId、VolumeName
-FolderRelativePath（必填）	要更新的文件夹的相对路径。参数别名：FolderName
-Policy	Enterprise Vault 从文件夹归档项目时应使用的文件夹策略的名称或条目 ID。如果指定文件夹位于 Celerra/VNX 文件服务器上，并且策略已启用“删除占位符时删除已归档的项目”设置，则系统会提示您进行确认。参数别名：PolicyId、PolicyName
-IgnoreVolumeRules	指定 Enterprise Vault 在归档此文件夹时应忽略卷策略规则。如果尚未指定文件夹策略，则此选项不可用。
-UseVolumePolicy	指定 Enterprise Vault 从此文件夹归档项目时应使用卷策略。不能同时指定 -UseVolumePolicy 和 -Policy 参数。
-DisableArchivingOnFolder	为指定文件夹禁用文件系统归档。
-DisableArchivingOnSubFolders	为指定文件夹的子文件夹禁用文件系统归档。
-IncludeRetentionFolders	指定 Enterprise Vault 是否应更新保留文件夹。与 -DisableArchivingOnFolder 和 -DisableArchivingOnSubFolders 一起使用可禁用指定文件夹或子文件夹上的文件系统归档。
-Confirm	运行 cmdlet 之前，系统会提示您进行确认。您可以使用该命令阻止当针对 Celerra/VNX 文件服务器上的文件夹运行此 cmdlet 时出现的确认提示。要阻止出现提示，请键入 -Confirm:$false。
-WhatIf	显示如果 cmdlet 运行会发生的情况。cmdlet 没有实际运行。

示例

Set-EVFSAFolder \\abc volume1 folder1 -Policy 'office files'
或
Set-EVFSAFolder -FileServer \\abc -Volume volume1 -FolderRelativePath folder1 -Policy 'office files'
或
Set-EVFSAFolder -FileServerName \\abc -VolumeName volume1 -FolderRelativePath folder1 -Policy 'office files'
或
Set-EVFSAFolder -Identifier \\abc\volume1\folder1 -Policy 'office files'
或
Set-EVFSAFolder -FolderPath \\abc\volume1\folder1 -Policy 'office files'
向文件服务器卷“volume1”（在 UNC 名称为“\\abc”的文件服务器上配置）上的文件夹“folder1”应用文件夹策略“office files”。
Set-EVFSAFolder '123...example.com' '456...example.com' folder1 -Policy '789...example.com' -DisableArchivingOnFolder -DisableArchivingOnSubFolders -IgnoreVolumeRules
或
Set-EVFSAFolder -FileServer '123...example.com' -Volume '456...example.com' -FolderRelativePath folder1 -Policy '789...example.com' -DisableArchivingOnFolder -DisableArchivingOnSubFolders –IgnoreVolumeRules
或
Set-EVFSAFolder -FileServerId '123...example.com' -VolumeId '456...example.com' -FolderRelativePath folder1 -PolicyId '789...example.com' -DisableArchivingOnFolder -DisableArchivingOnSubFolders -IgnoreVolumeRules
向条目 ID 为“456...example.com”的文件服务器卷（在条目 ID 为“123...example.com”的文件服务器上配置）上的文件夹“folder1”应用条目 ID 为“789...example.com”的文件夹策略。此命令还会禁用指定文件夹及其子文件夹上的归档，并在归档文件夹时忽略卷策略规则。
Set-EVFSAFolder abc.example.com volume1 folder1 –UseVolumepolicy
或
Set-EVFSAFolder -FileServer abc.example.com -Volume volume1 -FolderRelativePath folder1 –UseVolumepolicy
或
Set-EVFSAFolder -FileServerDNSName abc.example.com -VolumeName volume1 -FolderRelativePath folder1 –UseVolumepolicy
或
Set-EVFSAFolder -FolderPath \\abc.example.com\volume1\folder1 -UseVolumepolicy
对文件服务器卷“volume1”（在完全限定域名为“abc.example.com”的文件服务器上配置）上的文件夹“folder1”应用卷策略。
Set-EVFSAFolder -FsaFolder $obj -UseVolumepolicy
在通过使用输入 FsaFolder 对象标识的文件夹上应用卷策略。
注意:
要创建 FsaFolder 对象，请运行以下命令：$obj = Get-EVFSAFolder -Identifier \\abc.example.com\volume1\folder1
Get-EVFSAFolder - Identifier \\abc.example.com\volume1\folder1 | Set-EVFSAFolder -UseVolumepolicy
将从 Get-EVFSAFolder cmdlet 获得的 FsaFolder 对象用管道传输至 Set-EVFSAFolder cmdlet，并对该文件夹应用卷策略。
Set-EVFSAFolder abc.example.com volume1 folder1 -IncludeRetentionFolders -DisableArchivingOnSubFolders
或
Set-EVFSAFolder -FileServer abc.example.com -Volume volume1 -FolderRelativePath folder1 -IncludeRetentionFolders -DisableArchivingOnSubFolders
或
Set-EVFSAFolder -FileServerDNSName abc.example.com -VolumeName volume1 -FolderRelativePath folder1 -IncludeRetentionFolders -DisableArchivingOnSubFolders
或
Set-EVFSAFolder -FolderPath \\abc.example.com\volume1\folder1 -IncludeRetentionFolders -DisableArchivingOnSubFolders
对文件服务器卷“volume1”（在完全限定域名为“abc.example.com”的文件服务器上配置）上的保留文件夹“folder1”的子文件夹禁用归档。

输出

下表中列出了可用的 Set-EVFSAFolder 属性：

表： Set-EVFSAFolder 属性

名称	类型	说明
FolderPath	字符串	为文件系统归档启用的文件夹的完整路径。该路径的格式为 \\文件服务器名称\卷名称\文件夹相对路径。
FolderName	字符串	此文件夹的相对路径。
IsRetentionFolder	布尔值	指定文件夹是否为保留文件夹。
FolderPolicyName	字符串	Enterprise Vault 用于从文件夹归档项目的文件夹策略的名称。
VolumePolicyName	字符串	Enterprise Vault 用于从卷归档项目的卷策略的名称。
IgnoreVolumeRules	字符串	指定 Enterprise Vault 从此文件夹归档项目时应忽略卷策略规则。
ArchivingEnabledOnFolder	布尔值	指定是否在文件夹上启用文件系统归档功能。
ArchivingEnabledOnSubfolders	布尔值	指定是否在文件夹的子文件夹上启用文件系统归档功能。
FileServerName	字符串	用于托管此文件夹的文件服务器的完全限定 DNS 名称。
FileServerId	字符串	用于托管此文件夹的文件服务器的 ID。
VolumeName	字符串	用于托管此文件夹的卷的名称。
VolumeId	字符串	用于托管此文件夹的卷的 ID。
FolderId	字符串	此文件夹的 ID。
FolderPolicyId	字符串	Enterprise Vault 用于从文件夹归档项目的文件夹策略的 ID。
VolumePolicyId	字符串	Enterprise Vault 用于从卷归档项目的卷策略的 ID。

请参见Get-EVSite。
请参见Get-EVFSAFolder。
请参见New-EVFSAFolder。
请参见Remove-EVFSAFolder。