New-FsrmFileScreenException

New-FsrmFileScreenException

Creates a file screen exception.

構文

Parameter Set: cim:CreateInstance0
New-FsrmFileScreenException [-Path] <String> [-AsJob] [-CimSession <CimSession[]> ] [-Description <String> ] [-IncludeGroup <String[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The New-FsrmFileScreenException cmdlet creates a file screen exception. A file screen exception is a special type of file screen that overrides any file screening that would otherwise apply to a folder, and all its subfolders, in a designated exception path.

A file screen exception creates an exception to any rules derived from a parent folder. To determine which file types the exception allows, you can specify file groups for a file screen exception.

You cannot create a file screen exception on a folder for which you already have a file screen. You must assign the exception to a subfolder or make changes to the existing file screen.

パラメーター

-AsJob

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-Description<String>

Specifies a description for a file screen exception.

-IncludeGroup<String[]>

Specifies an array of names of file groups that you want to exclude from file screening.

-Path<String>

Specifies a valid local path to a folder. The exception applies to the selected folder and all of its subfolders.

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#MSFT_FSRMFileScreenException

例

Example 1: Create a file screen exception

This command creates a file screen exception on C:\Share1–IncludeGroup that allows users to create files that are part of the "Text Files" file group.

PS C:\> New-FsrmFileScreenException -Path "C:\Share1–IncludeGroup" -IncludeGroup "Text Files"

関連トピック

Get-FsrmFileScreenException

Set-FsrmFileScreenException

Remove-FsrmFileScreenException