New-QuarantinePermissions

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

New-QuarantinePermissions コマンドレットを使用して、New-QuarantineTag コマンドレットで使用する検疫アクセス許可オブジェクトを作成します。

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

構文

New-QuarantinePermissions
   [-PermissionToBlockSender <Boolean>]
   [-PermissionToDelete <Boolean>]
   [-PermissionToDownload <Boolean>]
   [-PermissionToPreview <Boolean>]
   [-PermissionToRelease <Boolean>]
   [-PermissionToRequestRelease <Boolean>]
   [-PermissionToViewHeader <Boolean>]
   [<CommonParameters>]

説明

使用しないパラメーターの既定値は$falseであるため、$trueに設定するパラメーター (アクセス許可) のみを使用する必要があります。

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

例 1

$NoAccess = New-QuarantinePermissions

次の使用例は、セキュリティ & コンプライアンスの検疫タグの [アクセス許可なし] グループで使用されるのと同じアクセス許可を作成します。 permissions オブジェクトは、 という名前 $NoAccessの変数に格納されます。

同じWindows PowerShell セッションでは、New-QuarantineTag または Set-QuarantineTag コマンドの EndUserQuarantinePermissions パラメーター値に使用$NoAccessできます。

例 2

$LimitedAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRequestRelease $true

次の使用例は、セキュリティ & コンプライアンスの検疫タグの制限付きアクセス許可グループで使用されるのと同じアクセス許可を作成します。 permissions オブジェクトは、 という名前 $LimitedAccessの変数に格納されます。

同じWindows PowerShell セッションでは、New-QuarantineTag または Set-QuarantineTag コマンドの EndUserQuarantinePermissions パラメーター値に使用$LimitedAccessできます。

例 3

$FullAccess = New-QuarantinePermissions -PermissionToBlockSender $true -PermissionToDelete $true -PermissionToPreview $true -PermissionToRelease $true

次の使用例は、セキュリティ & コンプライアンスの検疫タグのフル アクセス許可グループで使用されるのと同じアクセス許可を作成します。 permissions オブジェクトは、 という名前 $FullAccessの変数に格納されます。

同じWindows PowerShell セッションでは、New-QuarantineTag または Set-QuarantineTag コマンドの EndUserQuarantinePermissions パラメーター値に使用$FullAccessできます。

パラメーター

-PermissionToBlockSender

PermissionToBlockSender パラメーターは、検疫されたメッセージ送信者をブロックされた送信者の一覧にユーザーが追加できるかどうかを指定します。 有効な値は次のとおりです。

  • $true: [送信者のブロック] ボタンは、エンド ユーザー検疫通知に含まれています。
  • $false: [送信者のブロック] ボタンは、エンド ユーザーの検疫通知には含まれません。 これは既定の値です。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToDelete

PermissionToDelete パラメーターは、ユーザーが検疫からメッセージを削除できるかどうかを指定します。 有効な値は次のとおりです。

  • $true: 検疫から削除ボタンは、検疫されたメッセージの詳細に含まれています。
  • $false: 検疫から削除ボタンは、検疫されたメッセージの詳細には含まれません。 これは既定の値です。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToDownload

PermissionToDownload パラメーターは、ユーザーが検疫からメッセージをダウンロードできるかどうかを指定します。 有効な値は次のとおりです。

  • $true: アクセス許可が有効になっています。
  • $false: アクセス許可が無効になっています。 これは既定の値です。

現時点では、この値は、エンド ユーザーのスパム通知や検疫されたメッセージの詳細に含まれるボタンには影響しません。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToPreview

PermissionToPreview パラメーターは、ユーザーが検疫されたメッセージをプレビューできるかどうかを指定します。 有効な値は次のとおりです。

  • $true: 検疫されたメッセージの詳細には、[プレビュー メッセージ] ボタンが含まれています。
  • $false: [プレビュー メッセージ] ボタンは、検疫されたメッセージの詳細には含まれません。 これは既定の値です。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToRelease

PermissionToRelease パラメーターは、ユーザーが検疫からメッセージを直接解放できるかどうかを指定します。 有効な値は次のとおりです。

  • $true: [リリース] ボタンはエンド ユーザーのスパム通知に含まれ、検疫されたメッセージの詳細には [リリース メッセージ] ボタンが含まれます。
  • $false: [リリース] ボタンはエンド ユーザーのスパム通知には含まれず、検疫されたメッセージの詳細には [リリース メッセージ] ボタンは含まれません。 これは既定の値です。

このパラメーターと PermissionToRequestRelease パラメーターを$trueに設定しないでください。 1 つのパラメーターを $true に設定し、もう 1 つを $falseに設定するか、両方のパラメーターを $false に設定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToRequestRelease

PermissionToRequestRelease パラメーターは、ユーザーが検疫から解放されるメッセージを要求できるかどうかを指定します。 要求は管理者によって承認される必要があります。有効な値は次のとおりです。

  • $true: [リリース] ボタンはエンド ユーザーのスパム通知に含まれ、検疫されたメッセージの詳細には [リリース メッセージ] ボタンが含まれます。
  • $false: [リリース] ボタンはエンド ユーザーのスパム通知には含まれず、検疫されたメッセージの詳細には [リリース メッセージ] ボタンは含まれません。 これは既定の値です。

このパラメーターと PermissionRelease パラメーターを$trueに設定しないでください。 1 つのパラメーターを $true に設定し、もう 1 つを $falseに設定するか、両方のパラメーターを $false に設定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermissionToViewHeader

PermissionToViewHeader パラメーターは、ユーザーが検疫されたメッセージのメッセージ ヘッダーを表示できるかどうかを指定します。 有効な値は次のとおりです。

  • $true: アクセス許可が有効になっています。
  • $false: アクセス許可が無効になっています。 これは既定の値です。

現時点では、この値は、エンド ユーザーのスパム通知や検疫されたメッセージの詳細に含まれるボタンには影響しません。 [メッセージ ヘッダーの表示] ボタンは、検疫されたメッセージの詳細で常に使用できます。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection