Search <book_title>...

Enterprise Vault™ PowerShell Cmdlet

Last Published: 2018-03-28

Product(s): Enterprise Vault (12.3)

Set-EVFSAFileServer

Set-EVFSAFileServer 可更新作为文件系统归档目标添加的现有文件服务器的指定设置。您可以使用 -Identifier 或 -FileServer 指定文件服务器。

此 cmdlet 具有多个可选参数。您可以使用这些参数更新不同的文件服务器。

对于 Windows 文件服务器，可以使用 -EnableArchiving、-ActionOnPlaceholderDelete、-EnablePassthroughRecall、-PassthroughRecallCacheLocation 和 -PassthroughRecallCacheSizeInGB。
对于 NetApp 7-模式文件服务器，可以使用 -EnableArchiving、-EnablePassthroughRecall、-ActionOnPlaceholderDelete、-EnablePlaceholderRecalls、-MaxRecallThreads、-RecallLimitMaxRecalls、-RecallLimitTimeInterval 和 -IgnoreRecallLimitForLocalAdministrators。
对于 C-Mode 文件服务器，可以使用 -EnableArchiving、-ActionOnPlaceholderDelete、-EnablePlaceholderRecalls、-MaxRecallThreads、-RecallLimitMaxRecalls、-RecallLimitTimeInterval 和 -IgnoreRecallLimitForLocalAdministrators。
对于 Celerra/VNX 文件服务器，可以使用 -EnableArchiving、-UsePlaceholderShortcuts、-DataMoverAccountDetails、-PortNumber 和 -SSLRequired。

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

语法

Set-EVFSAFileServer [-SiteId <String>] [-Identifier] <String> [-EnableArchiving [<SwitchParameter>]] [-ActionOnPlaceholderDelete {RetainArchivedFile | DeleteArchivedFile}] [-EnablePassthroughRecall [<SwitchParameter>]] [-PassthroughRecallCacheLocation [<String>]] [-PassthroughRecallCacheSizeInGB [<Integer >]] [-EnablePlaceholderRecalls [<SwitchParameter>]] [-MaxRecallThreads [<Integer>]] [-RecallLimitMaxRecalls [<Integer>]] [-RecallLimitTimeInterval [<Integer>]] [-IgnoreRecallLimitForLocalAdministrators [<SwitchParameter>]] [-UsePlaceholderShortcuts [<SwitchParameter>]] [-DataMoverAccountDetails [<PSCredential>]] [-PortNumber [<Integer>]] [-SSLRequired [<SwitchParameter>]] [<CommonParameters>]

Set-EVFSAFileServer [-SiteId <String>] [-FileServer] <-FileServer> [-EnableArchiving [<SwitchParameter>]] [-ActionOnPlaceholderDelete {RetainArchivedFile | DeleteArchivedFile}] [-EnablePassthroughRecall [<SwitchParameter>]] [-PassthroughRecallCacheLocation [<String>]] [-PassthroughRecallCacheSizeInGB [<Integer >]] [-EnablePlaceholderRecalls [<SwitchParameter>]] [-MaxRecallThreads [<Integer>]] [-RecallLimitMaxRecalls [<Integer>]] [-RecallLimitTimeInterval [<Integer>]] [-IgnoreRecallLimitForLocalAdministrators [<SwitchParameter>]] [-UsePlaceholderShortcuts [<SwitchParameter>]] [-DataMoverAccountDetails [<PSCredential>]] [-PortNumber [<Integer>]] [-SSLRequired [<SwitchParameter>]] [<CommonParameters>]

参数

表：Set-EVFSAFileServer 参数

参数	说明
-SiteId（必填）	在其中配置文件服务器的 Enterprise Vault 站点的 ID。如果省略此参数，Set-EVFSAFileServer 将使用运行此命令的 Enterprise Vault 服务器所在站点的 ID。您可以使用 Get-EVSite 获取站点 ID。
-Identifier（必填）	在 Enterprise Vault 站点中配置的文件服务器目标的完全限定 DNS 名称、UNC 名称或条目 ID。此名称应该与添加文件服务器时使用的名称或管理控制台显示的名称相同。可以使用 Get-EVFSAFileServer 获取文件服务器名称。参数别名：FileServerDNSName、FileServerName、FileServerId。
-FileServer	指定 FileServer 对象。请注意，cmdlet 仅使用指定对象中的 FileServerId 属性来标识文件服务器目标。您需要指定要更新的参数。
-EnableArchiving	在文件服务器上启用文件系统归档。要禁用，请键入 -EnableArchiving:$false。
-ActionOnPlaceholderDelete	指定当占位符被删除时，是保留还是删除已归档文件。可能的值为 RetainArchivedFile 和 DeleteArchivedFile。
-EnablePassthroughRecall	在 Windows 和 NetApp 7-模式文件服务器上启用直通撤回。对于 NetApp 文件管理器，直通撤回使用在 Enterprise Vault 服务器的属性中定义的缓存位置。如果该缓存不存在，则必须手动配置它。
-PassthroughRecallCacheLocation	指定 Windows 文件服务器的直通撤回缓存位置。
-PassthroughRecallCacheSizeInGB	指定 Windows 文件服务器的直通撤回缓存位置大小 (GB)。
-EnablePlaceholderRecalls	在 NetApp 文件服务器上启用占位符撤回。
-MaxRecallThreads	指定在 NetApp 文件服务器上撤回项目时使用的最大撤回线程数。该值等于同时撤回数。
-RecallLimitMaxRecalls	指定允许用户在 NetApp 文件服务器上于指定期限内撤回的最大项目数。
-RecallLimitTimeInterval	指定与“RecallLimitMaxRecalls”一起使用以控制 NetApp 文件服务器上撤回项目速率的时间间隔（以秒为单位）。
-IgnoreRecallLimitForLocalAdministrators	控制撤回限制是否适用于 NetApp 文件服务器的本地 Administrators 组成员。
-UsePlaceholderShortcuts	在 Celerra/VNX 文件服务器上启用占位符快捷方式。
-DataMoverAccountDetails	指定可由 Enterprise Vault 用于身份验证的 Celerra/VNX Data Mover 帐户的用户名和密码。
-PortNumber	指定用于配置 Data Mover 服务 (DHSM) 的 Celerra/VNX 端口号。
-SSLRequired	指定在启用占位符快捷方式后，Celerra/VNX Data Mover HTTP 服务器是否使用安全套接字层 (SSL)。

示例

Set-EVFSAFileServer -Identifier \\abc –EnableArchiving
或
Set -EVFSAFileServer -FileServerName \\abc –EnableArchiving
为 UNC 名称为“\\abc”的文件服务器启用文件系统归档。
Set-EVFSAFileServer -SiteId 198...example.com -Identifier abc.example.com –EnableArchiving:$false
或
Set-EVFSAFileServer -SiteId 198...example.com –FileServerDNSName abc.example.com –EnableArchiving:$false
在完全限定域名为“abc.example.com”的文件服务器上禁用文件系统归档。
Set-EVFSAFileServer -Identifier \\NetAppFS -EnablePlaceholderRecalls -MaxRecallThreads 10 -RecallLimitMaxRecalls 20 -RecallLimitTimeInterval 30 – IgnoreRecallLimitForLocalAdministrators
在 UNC 名称为“\\NetAppFS”的 NetApp 文件服务器上启用占位符撤回、更新最大撤回线程数以及管理员可撤回文件的速率。此命令还指定应对本地 Administrators 组忽略的撤回限制。
Set-EVFSAFileServer -Identifier \\VNXFS -UsePlaceHolderShortcuts -PortNumber 5080 -SSLRequired:$false -DataMoverAccountDetails (Get-Credential)
为 UNC 名称为“\\VNXFS”的 Celerra/VNX 文件服务器启用占位符快捷方式并更新 Data Mover 帐户详细信息。
Set-EVFSAFileServer \\abc -ActionOnPlaceholderDelete RetainArchivedFile
对于 UNC 名称为“\\abc”的文件服务器，将针对占位符删除设置执行的操作更新为“保留已归档文件”。
Set-EVFSAFileServer \\abc -EnablePassthroughRecall -PassthroughRecallCacheLocation “C:\CacheLocation” -PassthroughRecallCacheSizeInGB 5
在 UNC 名称为“\\abc”的 Windows 文件服务器上启用直通撤回。此命令还会更新直通撤回缓存位置和缓存大小。
Set-EVFSAFileServer -FileServer $obj -EnableArchiving
为使用输入 FileServer 对象标识的文件服务器启用文件系统归档。
注意:
要创建 FileServer 对象，请运行以下命令：$obj = Get-EVFSAFileServer -FileServerName \\abc
Get-EVFSAFileServer -FileServerName \\abc | Set-EVFSAFileServer -EnableArchiving
将从 Get-EVFSAFileServer 中获得的 FileServer 对象传递到 Set-EVFSAFileServer 并启用文件服务器归档。
Set-EVFSAFileServer \\NetAppFS -EnablePassthroughRecall
在 UNC 名称为“\\NetAppFS”的 NetApp 7-模式文件服务器上启用直通撤回。

输出

下表列出了可用的属性：

表：Set-EVFSAFileServer - WindowsFileServer 属性列出了可用的 WindowsFileServer 属性。
表：Set-EVFSAFileServer - NetAppCModeFileServer 属性列出了可用的 NetAppCModeFileServer 属性。
表：Set-EVFSAFileServer - NetApp7ModeFileServer 属性列出了可用的 NetApp7ModeFileServer 属性。
表：Set-EVFSAFileServer - EMCCelerraOrVNXFileServer 属性列出了可用的 EMCCelerraOrVNXFileServer 属性。
表：Set-EVFSAFileServer - DHSMServiceConfiguration 属性列出了可用的 DHSMServiceConfiguration 属性。
表：Set-EVFSAFileServer - FileServer 属性列出了可用的文件服务器属性。

表：Set-EVFSAFileServer - WindowsFileServer 属性

名称	类型	说明
FileServerName	字符串	在 Enterprise Vault 站点中配置的文件服务器的 UNC 名称。
FileServerDNSName	字符串	在 Enterprise Vault 站点中配置的文件服务器的完全限定 DNS 名称。
FileServerId	字符串	在 Enterprise Vault 站点中配置的文件服务器的 ID。
FileServerType	FileServerType	文件服务器的类型。这种情况下，该值是 WindowsFileServer。
Archiving	布尔值	指定是否为此服务器启用文件系统归档功能。
SiteId	字符串	在其中配置文件服务器的 Enterprise Vault 站点的 ID。
PassthroughRecall	布尔值	指定是否已配置直接传递撤回。
PassthroughRecallCacheLocation	字符串	指定直接传递撤回缓存位置。
PassthroughRecallCacheSizeInGB	整数	指定直通撤回缓存位置大小 (GB)。
ActionOnPlaceholderDelete	ActionOnPlaceholderDelete	指定当已归档文件的占位符被删除时，是保留还是删除此已归档文件。值可以是 RetainArchivedFile 或 DeleteArchivedFile。

表：Set-EVFSAFileServer - NetAppCModeFileServer 属性

名称	类型	说明
FileServerName	字符串	在 Enterprise Vault 站点中配置的文件服务器的 UNC 名称。
FileServerDNSName	字符串	在 Enterprise Vault 站点中配置的文件服务器的完全限定 DNS 名称。
FileServerId	字符串	在 Enterprise Vault 站点中配置的文件服务器的 ID。
FileServerType	FileServerType	文件服务器的类型。在此情况下，该值是 NetAppCModeFileServer。
Archiving	布尔值	指定是否为此服务器启用文件系统归档功能。
SiteId	字符串	在其中配置文件服务器的 Enterprise Vault 站点的 ID。
ActionOnPlaceholderDelete	ActionOnPlaceholderDelete	指定当已归档文件的占位符被删除时，是保留还是删除此已归档文件。值可以是 RetainArchivedFile 或 DeleteArchivedFile。
PlaceholderRecallsEnabled	布尔值	指定是否为 NetApp 文件管理器启用针对占位符撤回的处理功能。
MaxRecallThreads	整数	在撤回项目时使用的最大撤回线程数。该值等于同时撤回数。
RecallLimitMaxRecalls	整数	指定允许用户撤回的最大项目数。
RecallLimitTimeInterval	整数	指定允许用户在指定期限内撤回的最大项目数。
IgnoreRecallLimitForLocalAdministrators	布尔值	指定撤回限制是否适用于 NetApp 文件管理器的本地 Administrators 组成员。

表：Set-EVFSAFileServer - NetApp7ModeFileServer 属性

名称	类型	说明
FileServerName	字符串	在 Enterprise Vault 站点中配置的文件服务器的 UNC 名称。
FileServerDNSName	字符串	在 Enterprise Vault 站点中配置的文件服务器的完全限定 DNS 名称。
FileServerId	字符串	在 Enterprise Vault 站点中配置的文件服务器的 ID。
FileServerType	FileServerType	文件服务器的类型。在这种情况下，该值是 NetApp7ModeFileServer。
Archiving	布尔值	指定是否为此服务器启用文件系统归档功能。
SiteId	字符串	在其中配置文件服务器的 Enterprise Vault 站点的 ID。
ActionOnPlaceholderDelete	ActionOnPlaceholderDelete	指定当已归档文件的占位符被删除时，是保留还是删除此已归档文件。值可以是 RetainArchivedFile 或 DeleteArchivedFile。
PassthroughRecall	布尔值	指定是否已配置直接传递撤回。
PlaceholderRecallsEnabled	布尔值	指定是否为 NetApp 文件管理器启用针对占位符撤回的处理功能。
MaxRecallThreads	整数	在撤回项目时使用的最大撤回线程数。该值等于同时撤回数。
RecallLimitMaxRecalls	整数	指定允许用户撤回的最大项目数。
RecallLimitTimeInterval	整数	指定允许用户在指定期限内撤回的最大项目数。
IgnoreRecallLimitForLocalAdministrators	布尔值	指定撤回限制是否适用于 NetApp 文件管理器的本地 Administrators 组成员。

表：Set-EVFSAFileServer - EMCCelerraOrVNXFileServer 属性

名称	类型	说明
FileServerName	字符串	在 Enterprise Vault 站点中配置的文件服务器的 UNC 名称。
FileServerDNSName	字符串	在 Enterprise Vault 站点中配置的文件服务器的完全限定 DNS 名称。
FileServerId	字符串	在 Enterprise Vault 站点中配置的文件服务器的 ID。
FileServerType	FileServerType	文件服务器的类型。对于 Celerra 或 VNX，该值是 EMCCelerraOrVNXFileServer。
Archiving	布尔值	指定是否为此服务器启用文件系统归档功能。
SiteId	字符串	在其中配置文件服务器的 Enterprise Vault 站点的 ID。
PlaceholdersEnabled	布尔值	指定在已启用策略创建快捷方式的情况下，是否要在文件服务器的共享上创建占位符。
DHSMServiceConfiguration	DHSMServiceConfiguration	指定在创建占位符期间所需的 DHSM 服务配置。

表：Set-EVFSAFileServer - DHSMServiceConfiguration 属性

名称	类型	说明
UserName	字符串	指定 Enterprise Vault 用于对 DHSM 服务进行身份验证的 Data Mover 用户名。
Password	SecureString	指定 Enterprise Vault 用于对 DHSM 服务进行身份验证的 Data Mover 帐户的密码。该密码以加密格式存储在 Enterprise Vault Directory 数据库中。
PortNumber	整数	指定已在其中配置 DHSM 的端口号。
SSLRequired	布尔值	指定 DHSM 服务是否需要使用 SSL 连接。

表：Set-EVFSAFileServer - FileServer 属性

名称	类型	说明
FileServerName	字符串	在 Enterprise Vault 站点中配置的文件服务器的 UNC 名称。
FileServerDNSName	字符串	在 Enterprise Vault 站点中配置的文件服务器的完全限定 DNS 名称。
FileServerId	字符串	在 Enterprise Vault 站点中配置的文件服务器的 ID。
FileServerType	FileServerType	文件服务器的类型。这种情况下，该值是 OtherCIFSFileServer。
Archiving	布尔值	指定是否为此服务器启用文件系统归档功能。
SiteId	字符串	在其中配置文件服务器的 Enterprise Vault 站点的 ID。