次の方法で共有

New-SweepRule

モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

New-SweepRule コマンドレットを使用して、メールボックスのスイープ ルールを作成します。 スイープ ルールは一定の間隔で実行され、受信トレイのクリーンを維持するのに役立ちます。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-SweepRule
   [-Name] <String>
   -Provider <String>
   [-Confirm]
   [-DestinationFolder <MailboxFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-ExceptIfFlagged <Boolean>]
   [-ExceptIfPinned <Boolean>]
   [-KeepForDays <Int32>]
   [-KeepLatest <Int32>]
   [-Mailbox <MailboxIdParameter>]
   [-Sender <RecipientIdParameter>]
   [-SourceFolder <MailboxFolderIdParameter>]
   [-SystemCategory <SystemCategoryType>]
   [-WhatIf]
   [<CommonParameters>]

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

New-SweepRule -Name "From Michelle" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender michelle@fabrikam.com -KeepLatest 1

次の使用例は、Felipe Apodaca のメールボックスに "From Michelle" という名前の新しいスイープ ルールを作成し、受信トレイ フォルダーの michelle@fabrikam.com から最新のメッセージを保持し、古いメッセージを削除済みアイテム フォルダーに移動します。

例 2

New-SweepRule -Name "From Lila" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender lila@fabrikam.com -KeepForDays 10

次の使用例は、10 日を超える受信トレイ フォルダー内の lila@fabrikam.com から削除済みアイテム フォルダーにメッセージを移動する、"From Lila" という名前の新しいスイープ ルールを Felipe Apodaca のメールボックスに作成します。

例 3

New-SweepRule -Name "From Jeff" -Mailbox "Felipe Apodaca" -Provider Exchange16 -Sender jeffm@fabrikam.com -SourceFolder "Felipe:\Sent Items" -KeepForDays 10

次の使用例は、10 日より前の送信済みアイテム フォルダーの jeffm@fabrikam.com から削除済みアイテム フォルダーにメッセージを移動する、Felipe Apodaca のメールボックスに "From Jeff" という名前の新しいスイープ ルールを作成します。

パラメーター

-Confirm

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DestinationFolder

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

DestinationFolder パラメーターは、指定したフォルダーにメッセージを移動するスイープ ルールのアクションを指定します。 構文は MailboxID:\ParentFolder[\SubFolder] です。

MailboxIDの値には、メールボックスを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)

このパラメーターの値の例は、 john@contoso.com:\Unimportant または John:\Inbox\Miscです。 既定値は MailboxID:\Deleted Items です。

型:MailboxFolderIdParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DomainController

適用対象: Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

型:Fqdn
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Enabled

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

Enabled パラメーターは、スイープ ルールを有効にするか無効にするかを指定します。 有効な値は次のとおりです。

  • $true: ルールが有効になっています。 これは既定の値です。
  • $false: ルールが無効になっています。

ルールを作成した後に、Enable-SweepRule と Disable-SweepRule コマンドレットを使用して有効または無効にすることができます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExceptIfFlagged

適用対象: Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

ExceptIfFlagged パラメーターは、メッセージ フラグが適用されたメッセージを検索するスイープ ルールの例外を指定します。 有効な値は次のとおりです。

  • $true: ルール アクションは、メッセージ フラグが適用されたメッセージには適用されません。
  • $false: 例外は使用されません。

一般的なメッセージ フラグの値は次のとおりです。

  • 任意
  • コール
  • DoNotForward
  • フォロー アップ
  • ForYourInformation
  • 転送
  • NoResponseNecessary
  • 読み取り
  • 返信
  • ReplyToAll
  • レビュー
型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExceptIfPinned

適用対象: Exchange Server 2016、Exchange Server 2019

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

PinMessage パラメーターは、ピン留めされたメッセージを検索するスイープ ルールの例外を指定します。 有効な値は次のとおりです。

  • $true: ルール アクションは、受信トレイの上部にピン留めされたメッセージには適用されません。
  • $false: 例外は使用されません。
型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-KeepForDays

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

KeepForDays パラメーターは、ルールの条件に一致するメッセージを保持する日数を指定するスイープ ルールのアクションを指定します。 その日数が経過した後、メッセージは DestinationFolder パラメーターで指定されている場所 (既定では削除済みアイテム フォルダー) に移動されます。

KeepLatest パラメーターではこのパラメーターを使用できません。スイープ ルールには KeepForDays または KeepLatest パラメーター値を含める必要があります。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-KeepLatest

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

KeepLatest パラメーターは、ルールの条件に一致するメッセージの数を指定するスイープ ルールのアクションを指定します。 メッセージがその数を超えたとき、最も古いメッセージは DestinationFolder パラメーターで指定されている場所 (既定では削除済みアイテム フォルダー) に移動されます。

KeepForDays パラメーターでこのパラメーターを使用することはできません。スイープ ルールには KeepForDays または KeepLatest パラメーター値を含める必要があります。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Mailbox

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

Mailbox パラメーターは、スイープ ルールを作成するメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)
型:MailboxIdParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

Name パラメーターは、スイープ ルールの名前を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。

型:String
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Provider

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

Provider パラメーターは、スイープ ルールのプロバイダーを指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。

Outlook on the webで作成するスイープ ルールの場合、既定値は Exchange16 です。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Sender

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

Sender パラメーターは、メッセージで指定された送信者を検索するスイープ ルールの条件を指定します。 内部送信者の場合、その送信者を一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • 電子メール アドレス
  • GUID

外部送信者の場合は、各自のメール アドレスを使用します。

型:RecipientIdParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SourceFolder

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

SourceFolder パラメーターは、指定したフォルダー内のメッセージを検索するスイープ ルールの条件を指定します。 構文は MailboxID:\ParentFolder[\SubFolder] です。

MailboxIDの値には、メールボックスを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)

このパラメーターの値の例は、 john@contoso.com:\Marketing または John:\Inbox\Reportsです。 既定値は MailboxID:\Inbox です。

型:MailboxFolderIdParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SystemCategory

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

SystemCategory パラメーターは、指定されたシステム カテゴリを持つメッセージを検索するスイープ ルールの条件を指定します。 システム カテゴリは、組織内のすべてのメールボックスで使用できます。 有効な値は次のとおりです。

  • NotDefined
  • 法案
  • ドキュメント
  • DocumentPlus
  • イベント
  • ファミリー
  • File
  • 逃走
  • FromContact
  • 重要
  • LiveView
  • 宿泊施設
  • MailingList
  • ニュースレター
  • Photo
  • 買う
  • RentalCar
  • RestaurantReservation
  • RetiredPromotion
  • ShippingNotification
  • 買い物
  • SocialUpdate
  • 旅行
  • ビデオ
型:SystemCategoryType
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

適用対象: Exchange Server 2016 年、Exchange Server 2019、Exchange Online

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False