Set-QuarantinePermissions
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Set-QuarantinePermissions コマンドレットを使用して、検疫タグ (New-QuarantineTag または Set-QuarantineTag コマンドレット) で使用される検疫アクセス許可オブジェクトを変更します。 このコマンドレットは、New-QuarantinePermissions コマンドレットによって作成され、Windows PowerShell セッションで現在使用できる変数に格納されているアクセス許可オブジェクトでのみ機能します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-QuarantinePermissions
-QuarantinePermissionsObject <QuarantinePermissions>
[-PermissionToBlockSender <Boolean>]
[-PermissionToDelete <Boolean>]
[-PermissionToDownload <Boolean>]
[-PermissionToPreview <Boolean>]
[-PermissionToRelease <Boolean>]
[-PermissionToRequestRelease <Boolean>]
[-PermissionToViewHeader <Boolean>]
[<CommonParameters>] 説明
変更する permissions オブジェクトの現在の値を確認するには、変数名をコマンドとして実行します。 たとえば、 コマンド $Perms を実行して、変数に格納されている検疫タグのアクセス許可を $Perms 確認します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-QuarantinePermissions -QuarantinePermissionsObject $Perms -PermissionToRequestRelease $true -PermissionToRelease $false次の使用例は、同じWindows PowerShell セッションで以前に作成された終了$Permsアクセス許可オブジェクトの指定された検疫タグのアクセス許可を変更します ($Perms変数は引き続き使用可能で、設定されています)。
同じWindows PowerShell セッションでは、New-QuarantineTag または Set-QuarantineTag コマンドの EndUserQuarantinePermissions パラメーター値に使用$Permsできます。
パラメーター
-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 |
-QuarantinePermissionsObject
QuarantinePermissionsObject パラメーターは、変更する検疫アクセス許可オブジェクトを含む変数を指定します。 たとえば、 コマンド $Perms = New-QuarantinePermissions <permissions>を実行した場合は、このパラメーターの値 $Perms を使用します。
| Type: | QuarantinePermissions |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |