<book_title> を検索 ...

Enterprise Vault™ PowerShell Cmdlets

Last Published: 2024-03-04

Product(s): Enterprise Vault (15.0)

New-EVSMTPTarget

New-EVSMTPTarget は指定された SMTP アドレスなどのプロパティを伴う新しい SMTP ターゲットを追加します。-SiteId パラメータを使ってサイト ID を指定しない場合で、New-EVSMTPTarget がサイトを判別できない場合は、サイト ID を入力するように求められます。

New-EVSMTPTarget は、ディレクトリと、サイト内の各 Enterprise Vault SMTP サーバーに SMTP ターゲット情報を追加します。

新しい SMTP ターゲットを追加するには、次の項目を指定する必要があります。

ターゲット SMTP の電子メールアドレス（-Name を使用）
既存の SMTP ポリシー（-PolicyName または -PolicyId を使用）
既存の保持カテゴリ (-RetentionCategory または -RetentionCategoryId を使用)
ターゲットに関連付けるアーカイブのリスト。-ArchiveName または -ArchiveId を使用して、1 つのアーカイブを関連付けます。-ArchiveNames または -ArchiveIds を使用して、複数のアーカイブを追加します。アーカイブ ID とアーカイブ名の両方を指定することはできません。
SMTP ジャーナル設定の種類 (-TargetType を使用)
使用するアーカイブの種類 (-ArchiveType を使用)

名前または ID、またはこれら両方によってポリシーと保持カテゴリを指定することができます。名前と ID の両方を使う場合、これら 2 つは同じポリシーまたは保持カテゴリに関連している必要があります。

ターゲットのアーカイブを有効にするには -ArchivingEnabled $true を、アーカイブを無効にするには -ArchivingEnabled $false を使用します。

すでに存在するターゲットを指定したり、サイト内に存在しない SMTP 設定を指定したりすると、New-EVSMTPTarget は失敗します。

New-EVSMTPTarget がいずれかの Enterprise Vault SMTP サーバー上の SMTP 設定を更新できない場合、GetFailedEVServerList 機能で更新されなかったサーバーを一覧表示できます。例については、Get-EVSMTPTarget のヘルプを参照してください。

New-EVSMTPTarget は、サイト内で SMTP サーバーがインストールまたは構成されていない場合には警告を表示します。Enterprise Vault サーバー上で SMTP サーバーと SMTP アーカイブタスクがインストールされて構成されていないと、Enterprise Vault ではターゲットメッセージをアーカイブできません。Enterprise Vault メディアから SMTP アーカイブコンポーネントをインストールする方法については、『インストール/設定』を参照してください。SMTP アーカイブを構成する方法については、『SMTP アーカイブの設定』を参照してください。

New-EVSMTPTarget は、スナップイン Symantec.EnterpriseVault.PowerShell.AdminAPI.dll によって提供されます。

構文

New-EVSMTPTarget [-SiteId] <String> [-Name] <String> [-PolicyId <String>] [-PolicyName <String>] [-RetentionCategoryId <String>] [-RetentionCategory <String>] [-ArchiveId <String>] [-ArchiveName <String>] [-TargetType] <object> [-ArchiveType] <object> [-ArchivingEnabled <Boolean>] [-RetryCount <String>] [<CommonParameters>]

New-EVSMTPTarget [-SiteId] <String> [-Name] <String> [-PolicyId <String>] [-PolicyName <String>] [-RetentionCategoryId <String>] [-RetentionCategory <String>] [-ArchiveIds <Symantec.EnterpriseVault.Admin.SMTPTargetArchiveIDs>] [-ArchiveNames <Symantec.EnterpriseVault.Admin.SMTPTargetArchiveNames>] [-TargetType] <object> [-ArchiveType] <object> [-ArchivingEnabled <Boolean>] [-RetryCount <String>] [<CommonParameters>]

パラメータ

表: New-EVSMTPTarget パラメータ

パラメータ	説明
-SiteId (必須)	SMTP ターゲットを追加するサイトの ID。
-Name (必須)	ターゲットの SMTP アドレス。
-PolicyId	SMTP ターゲットに関連付けされる既存の SMTP ポリシーの ID。
-PolicyName	SMTP ターゲットに関連付けされる既存の SMTP ポリシーの名前。
-RetentionCategoryId	SMTP ターゲットに関連付けされる既存の保持カテゴリの ID。
-RetentionCategory	SMTP ターゲットに関連付けされる既存の保持カテゴリの名前。
-ArchiveId -ArchiveName (必須)	ArchiveId または ArchiveName のいずれかを使用して、Enterprise Vault がターゲットのメッセージをアーカイブするアーカイブを指定します。次の点に注意してください。アーカイブ ID とアーカイブ名の両方を指定することはできません。複数のアーカイブを SMTP ジャーナルまたは SMTP グループジャーナルのターゲットに関連付けるには、ArchiveIds または ArchiveNames を使用します。
-ArchiveIds -ArchiveNames (必須)	ArchiveIds または ArchiveNames のいずれかを使用して、複数のアーカイブを SMTP ジャーナルまたは SMTP グループジャーナルのターゲットに関連付けます。SMTPTargetArchiveIDs オブジェクトについて詳しくは、get-help about_SMTPTargetArchiveIDs と入力します。次の点に注意してください。アーカイブ ID とアーカイブ名の両方を指定することはできません。ターゲットに関連付けられているすべてのアーカイブで、保持設定が同じになっている必要があります。 1 つのアーカイブを SMTP ジャーナルまたは SMTP グループジャーナルのターゲットに関連付けるには、ArchiveId または ArchiveName を使用します。 SMTP メールボックスジャーナルのターゲットを作成するときに、これらのパラメータは使用できません。
-TargetType (必須)	SMTP ジャーナル設定の種類。有効なターゲットの種類は次のとおりです。 SMTPJournaling SMTPMailboxJournaling SMTPGroupJournaling ここで指定できる値は、SMTP サイトの設定、［選択したジャーナルのアーカイブ］を構成した方法によって決まります。ターゲットを、SMTP メールボックスジャーナルまたは SMTP グループジャーナルのターゲットとして追加するには、［選択したジャーナルのアーカイブ］が［包含］または［除外］になっていることを確認します。［選択したジャーナルのアーカイブ］が［非選択］に設定されている場合、このターゲットは SMTP ジャーナルとしてのみ追加できます。
-ArchiveType (必須)	Enterprise Vault がターゲットからメッセージをアーカイブ化するアーカイブの種類。ここで指定できる値は、-TargetType で指定する値によって決まります。-TargetType が SMTPJournaling または SMTPGroupJournaling の場合は、1 つまたは複数のアーカイブの種類を指定することができます。有効なアーカイブの種類は次のとおりです。 DominoJournal ExchangeJournal Shared SMTP -TargetType が SMTPMailboxJournaling の場合は、次のアーカイブの種類のいずれかを指定することができます。 ExchangeMailbox InternetMail
-ArchivingEnabled	ターゲットのメッセージ (受信と送信) をアーカイブするには、$true に設定します。ターゲットのアーカイブを無効にするには、$false に設定します。
-RetryCount	New-EVSMTPTarget がサイト内の Enterprise Vault SMTP サーバーに対してターゲット情報の更新を試行する最大回数。

例

New-EVSMTPTarget -SiteId 13E...example.com -Name JohnDoe@example.com -PolicyName 'SMTP policy' -ArchiveName SMTPLocal -TargetType SMTPMailboxJournaling -ArchiveType ExchangeMailbox
指定されたプロパティで新しい SMTP メールボックスジャーナルのターゲット「JohnDoe@example.com」を追加します。
C:\PS> $archIds = new-object Symantec.EnterpriseVault.Admin.SMTPTargetArchiveIDs
C:\PS> $archIds.Add("12DB...110000MW-EV-1-A")
C:\PS> $archIds.Add("15E1...210000MW-EV-1-A")
C:\PS> $archIds.Add("132C...410000MW-EV-1-A")
C:\PS> New-EVSMTPTarget -SiteId 13E9...EV1101.example.com -Name Jrnl@example.com -PolicyName 'SMTP policy' -RetentionCategory 'Standard retention' ArchiveIds $archIds -TargetType SMTPJournaling -ArchiveType SMTP -ArchivingEnabled $true
指定されたプロパティで新しい SMTP ターゲット「Jrnl@example.com」を追加し、指定したアーカイブを SMTP ターゲットに関連付けます。
C:\PS> $archNames = new-object Symantec.EnterpriseVault.Admin.SMTPTargetArchiveNames
C:\PS> $archNames.Add("SmtpArchive")
C:\PS> $archNames.Add("ExchJournal")
C:\PS> New-EVSMTPTarget -SiteId 13E...example.com -Name Jrnl@example.com -PolicyName 'SMTP policy' -RetentionCategory 'Standard retention' -ArchiveNames $archNames -ArchiveType "SMTP, ExchangeJournal" -TargetType SMTPJournaling
指定されたプロパティで新しい SMTP ジャーナルターゲット「Jrnl@example.com」を追加し、指定した SMTP アーカイブと ExchangeJournal アーカイブを SMTP ターゲットに関連付けます。
C:\PS> New-EVSMTPTarget -SiteId 13E9...EV1101.example.com -Name Jrnl@example.com -PolicyName 'SMTP policy' -RetentionCategory 'Standard retention' -ArchiveId B2DE...EV1101.example.com -ArchiveType SMTP -TargetType SMTPJournaling -ArchivingEnabled $true
指定されたプロパティで新しい SMTP ジャーナルターゲット「Jrnl@example.com」を追加し、指定した SMTP アーカイブを SMTP ターゲットに関連付けます。
C:\PS> New-EVSMTPTarget -SiteId 13E9...EV1101.example.com -Name JohnDoe@example.com -PolicyName 'SMTP policy' -RetentionCategory 'Standard retention' -ArchiveName SMTPLocal -ArchiveType SMTP -TargetType SMTPGroupJournaling -ArchivingEnabled $true
指定されたプロパティで新しい SMTP グループジャーナルターゲット「JohnDoe@example.com」を追加します。
C:\PS> New-EVSMTPTarget -SiteId 13E...example.com -Name JohnDoe@example.com -PolicyName 'SMTP policy' -RetentionCategory 'Standard retention' -ArchiveName ExchMbx -ArchiveType ExchangeMailbox -TargetType SMTPMailboxJournaling
指定されたプロパティで新しい SMTP メールボックスジャーナルターゲット「JohnDoe@example.com」を追加し、指定した ExchangeMailbox アーカイブを SMTP ターゲットに関連付けます。

出力

New-EVSMTPTarget は Symantec.EnterpriseVault.Admin.SMTPTarget と Symantec.EnterpriseVault.Admin.SmtpTargetArchiveInformation の種類のオブジェクトを返します。ここには、次の表に一覧表示されているプロパティが含まれています。

表: Symantec.EnterpriseVault.Admin.SMTPTarget プロパティ

名前	種類	説明
ArchivingEnabled	Boolean	現在アーカイブされている 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 ターゲットに使用されるアーカイブを含んでいるボルトストアの名前。