New-FsrmFmjCondition

New-FsrmFmjCondition

Creates a file management property condition object.

構文

Parameter Set: CreateFmjCondition0
New-FsrmFmjCondition [-Property] <String> [-Condition] <FmjConditionTypeEnum> [-AsJob] [-CimSession <CimSession[]> ] [-DateOffset <Int32> ] [-ThrottleLimit <Int32> ] [-Value <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The New-FsrmFmjCondition cmdlet creates a file management condition object. A file management condition object defines a condition that determines if a file management job acts on a file.

パラメーター

-AsJob

-CimSession<CimSession[]>

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

-Condition<FmjConditionTypeEnum>

Specifies the condition of the property that must be matched for the file management job. このパラメーターに対して使用できる値:
-- Equal
-- NotEqual
-- GreaterThan
-- LessThan
-- Contain
-- Exist
-- NotExist
-- StartWith
-- EndWith
-- ContainedIn
-- PrefixOf
-- SuffixOf
-- MatchesPattern

-DateOffset<Int32>

Specifies an offset from the Value parameter for DateTime values. The default value is 0.

-Property<String>

Specifies the property to compare for the condition. Specify one of the following values:
-- The name of a classification property definition on the server. (Do not specify the display name of the property definition.)
-- The string File.Name
-- The string File.DateCreated
-- The string File.DateLastModified
-- The string File.DateLastAccessed

The value of this parameter limits the values that other parameters to the cmdlet can accept as follows:

File.Name:
-- You can set the Condition parameter only to MatchesPattern.
-- The Value parameter must contain a semi-colon separated list of wildcard patterns.
-- You cannot specify the DateOffset parameter.

File.DateCreated, File.DateLastModified, or File.DateLastAccessed:
-- You can set the Condition parameter only to LessThan or Equal.
-- If you specify the DateOffset parameter, you can set the Value parameter to one of the following: File.DateCreated, File.DateLastModified, File.DateLastAccessed, or Date.Now.
-- If you do not specify the DateOffset parameter, you can set the Value parameter to a FileTime value.

The name of a classification property definition whose Type is DateTime:
-- You can set the Condition parameter to Exist, NotExist, Equal, NotEqual, LessThan, GreaterThan.
-- If you specify the DateOffset parameter, the Value parameter can contain one of the following: File.DateCreated, File.DateLastModified, File.DateLastAccessed, or Date.Now.
-- If you do not specify the DateOffset parameter, the Value parameter can contain a FileTime value.

The name of a classification property definition whose Type is not DateTime:
-- You cannot specify the DateOffset parameter.
-- If the Condition parameter is Exist or NotExist, you cannot specify the Value parameter.
-- If the Type is Integer, you can set the Condition parameter to Equal, NotEqual, Exist, NotExist, LessThan, GreaterThan.
-- If the Type is String, you can set the Condition parameter to Equal, NotEqual, Exist, NotExist, Contains, IsContainedIn, LessThan, GreaterThan, StartsWith, EndsWith, PrefixOf, SuffixOf.
-- If the Type is YesNo, you can set the Condition parameter to Equal, NotEqual, Exist, NotExist.
-- If the Type is OrderedList, you can set the Condition parameter to Equal, NotEqual, Exist, NotExist, LessThan, GreaterThan.
-- If the Type is SingleChoice, you can set the Condition parameter to Equal, NotEqual, Exist, NotExist.
-- If the Type is MultiChoice, you can set the Condition parameter to Equal, NotEqual, Exist, NotExist, Contains.
-- If the Type is MultiString, you can set the Condition parameter to Equal, NotEqual, Exist, NotExist, Contains.

-ThrottleLimit<Int32>

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

-Value<String>

Specifies a name of a file condition property value. Do not specify this parameter if you specify Exists or NotExist for the Condition parameter. If you specify the name of a DateTime property, specify the DateOffset parameter.

-Confirm

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

-WhatIf

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

<CommonParameters>

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

入力

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

出力

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

• Microsoft.Management.Infrastructure.CimInstance#MSFT_FSRMFMJCondition

例

Example 1: Create a property condition

This command creates a property condition that verifies that a file has a PII classification property set to true.

PS C:\> New-FsrmFmjCondition -Property "PII" -Condition Equal -Value "1"

Example 2: Create a condition based on a file classification

This command creates a condition based on the file’s classification. The command verifies that a file has a DatePublished classification property (of type DateTime) set to the file’s Last Modified timestamp.

PS C:\> New-FsrmFmjCondition -Property "DatePublished" -Condition Equal -Value "File.DateLastModified"

関連トピック

Get-FsrmClassificationPropertyDefinition