Search <book_title>...

Enterprise Vault™ PowerShell Cmdlet

Last Published: 2023-03-05

Product(s): Enterprise Vault (14.4)

Get-EVSMTPTarget

Get-EVSMTPTarget 返回在 Enterprise Vault 站点中配置的所有 SMTP 目标地址。如果您不使用 -SiteID 参数指定站点 ID，并且 Get-EVSMTPTarget 无法确定站点，则系统会提示您输入站点 ID。如果已指定 SMTP 目标的名称，则 Get-EVSMTPTarget 将获取该目标地址的属性。有关属性的说明，请参见 New-EVSMTPTarget 帮助。

运行 New-EVSMTPTarget、Set-EVSMTPTarget 或 Remove-EVSMTPTarget 时，Enterprise Vault 会更新 Enterprise Vault 目录中以及站点中每台 Enterprise Vault SMTP 服务器上的 SMTP 目标信息。如果 Enterprise Vault 无法更新任何 SMTP 服务器上的 SMTP 目标，可以使用 GetFailedEVServerList 函数列出 Enterprise Vault 无法更新的服务器。

Get-EVSMTPTarget 由管理单元 Symantec.EnterpriseVault.PowerShell.AdminAPI.dll 提供。

语法

Get-EVSMTPTarget [-SiteId] <String> [[-Name] <String>] [<CommonParameters>]

参数

表：Get-EVSMTPTarget 参数

参数	说明
-SiteId（必填）	要检索的 SMTP 目标的站点 ID。
-Name	要检索的 SMTP 目标的地址。

示例

Get-EVSMTPTarget -SiteId 13E...example.com
返回在 Enterprise Vault 站点中配置的所有 SMTP 目标。
您可以使用以下命令序列返回有关 SMTP 目标 JohnDoe@example.com 的信息：
- $st = New-Object Symantec.EnterpriseVault.Admin.SMTPTarget
  使用 New-Object 创建名为 $st 的新变量，用于保存 SMTPTarget 对象。
- $st.Name = "JohnDoe@example.com"
  使用 Name 参数指定 JohnDoe@example.com 为要检索的目标。
- $st.Read()
  使用 Read 方法将指定 SMTP 目标有关的信息检索到 $st。
- $st
  显示变量 $st 中包含的目标信息。例如：
```
Name                : JohnDoe@example.com
PolicyName          : Default SMTP Policy
PolicyId            : 138...example.com
RetentionCategory   : Default Retention Category (From Plan)
RetentionCategoryId : 100...example.com
ArchivingEnabled    : true
TargetArchives      : {exchangearchive}
SiteId              : 13E...example.com
TargetType          : SMTPMailboxJournaling
```
  在这种情况下，该 cmdlet 会将词语“(From Plan)”附加到保留类别名称。已向与 SMTP 目标关联的归档应用保留计划。由 Enterprise Vault 应用到已归档项目的保留类别是在保留计划中定义的保留类别。
使用以下命令之一同样可以显示此信息：
- Get-EVSMTPTarget -SiteId 13E...example.com -Name JohnDoe@example.com
- Get-EVSMTPTarget 13E...example.com JohnDoe@example.com
可以使用以下命令序列返回有关 SMTP 目标的信息，并查找其目标未由 New-EVSMTPTarget、Set-EVSMTPTarget 或 Remove-EVSMTPTarget 中的任何一个更新的服务器列表：
- $st = Get-EVSMTPTarget 13E...example.com JohnDoe@example.com
  将 SMTP 目标检索至变量 $sp。
- $st
  显示变量 $sp 中保存的目标信息。例如：
```
Name                : JohnDoe@example.com
PolicyName          : Default SMTP Policy
PolicyId            : 138...example.com
RetentionCategory   : Default Retention Category (From Plan)
RetentionCategoryId : 100...example.com
ArchivingEnabled    : true
TargetArchives      : {exchangearchive}
SiteId              : 13E...example.com
TargetType          : SMTPMailboxJournaling
```
- $st.TargetArchives
  以表格格式显示与 $st 中的目标关联的归档的以下详细信息：
  列标题
  示例值
  Name
  JohnDoe@example.com
  ArchiveName
  exchangearchive
  ArchiveType
  ExchangeMailbox
  ArchiveId
  128D...com
  VaultStore
  Express Vault Store
  EVServerName
  ev.example.com
- $st.GetFailedEVServerList()
  显示目标未更新的 Enterprise Vault 服务器列表。例如：
```
EV1101, EVSMTP11
```

列标题	示例值
Name	JohnDoe@example.com
ArchiveName	exchangearchive
ArchiveType	ExchangeMailbox
ArchiveId	128D...com
VaultStore	Express Vault Store
EVServerName	ev.example.com

输出

Get-EVSMTPTarget 返回 Symantec.EnterpriseVault.Admin.SMTPTarget 和 Symantec.EnterpriseVault.Admin.SmtpTargetArchiveInformation 类型的对象，其中包含下表中列出的属性。

表：Symantec.EnterpriseVault.Admin.SMTPTarget 属性

名称	类型	说明
ArchivingEnabled	布尔值	如果发送到/自 SMTP 目标的邮件当前已归档，则为 $true，否则为 $false。
Name	字符串	SMTP 目标地址。
PolicyId	字符串	与 SMTP 目标相关联的 SMTP 策略的 ID。
PolicyName	字符串	与 SMTP 目标相关联的 SMTP 策略。
RetentionCategory	字符串	Enterprise Vault 应用于新建归档项目的保留类别的名称。如果 Enterprise Vault 将词语“(From Plan)”附加到保留类别名称，则已将保留计划应用于与 SMTP 目标关联的归档。Enterprise Vault 将在计划中定义的保留类别应用到项目。如果未向归档分配保留计划，则生效的保留类别是在 SMTP 目标属性中定义的保留类别。
RetentionCategoryId	字符串	由 Enterprise Vault 应用于新归档项目的保留类别的 ID。与 RetentionCategory 一样，这取决于是否已将保留计划分配到 Enterprise Vault 在其中存储项目的归档。
SiteId	字符串	目标所属的站点的 ID。
TargetArchives	对象	Symantec.EnterpriseVault.Admin.SmtpTargetArchiveInformation：提供与 SMTP 目标地址关联的归档的列表。有关 TargetArchives 的详细信息，请在 PowerShell 提示符中键入 get-help about_SmtpTargetArchiveInformation。
TargetType	对象	与目标关联的 SMTP 日记记录配置的类型。

表：Symantec.EnterpriseVault.Admin.SmtpTargetArchiveInformation 属性

名称	类型	说明
ArchiveId	字符串	与 SMTP 目标相关联的归档的 ID。
ArchiveName	字符串	与 SMTP 目标相关联的归档的名称。
ArchiveType	对象	与 SMTP 目标相关联的归档的类型。
EVServerName	字符串	承载保管库存储的 Enterprise Vault 服务器。
Name	字符串	SMTP 目标地址。
VaultStoreName	字符串	包含用于 SMTP 目标的归档的保管库存储的名称。