New-CMTSStepConditionFolder

任务序列步骤 创建文件夹属性条件。

语法

New-CMTSStepConditionFolder
   [-FolderDateTimeOperator <VariableOperatorType>]
   -FolderPath <String>
   [-FolderTimestamp <DateTime>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 为任务序列 步骤创建文件夹属性条件对象。 然后,将New-CMTSStep * _ 或 _ Set-CMTSStep * _ cmdlet 之一与 _ Condition 或AddCondition参数一同使用。 例如 ,Set-CMTSStepApplyDataImage

有关详细信息,请参阅使用任务 序列编辑器:条件

有两种类型的检查可用于此条件:

  • 若要检查文件夹是否存在,请使用必需的 FolderPath 参数。
  • 若要同时检查文件夹时间戳,请使用 FolderTimestampFolderDateTimeOperator 参数。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\> 。 有关详细信息,请参阅 入门

示例

示例 1

此示例检查 Configuration Manager PowerShell 模块帮助文件文件夹是否存在和时间戳。 它会为文件夹创建一个条件对象,并且其时间戳大于 2021 年 8 月 2 日。

然后,它使用Set-CMTSStepRunPowerShellScript cmdlet 将此条件对象添加到默认操作系统部署任务序列的"运行PowerShell脚本"步骤中。

$folder = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US"
$datetime = Get-Date ("August 2, 2021")

$condition = New-CMTSStepConditionFolder -FolderPath $folder -FolderTimestamp $datetime -FolderDateTimeOperator Greater

$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"

Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition

此示例脚本在步骤上创建以下条件:

Folder C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US exists and timestamp greater than "8/1/2021 16:00:00"

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FolderDateTimeOperator

使用 FolderTimestamp 参数时,使用此参数指定任务序列的运算符以计算文件夹的时间戳。

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FolderPath

为此条件指定文件夹的完整路径。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FolderTimestamp

若要计算文件夹的时间戳,请使用此参数指定 datetime 对象。 若要获取此对象,请使用内置的 Get-Date cmdlet。

然后使用 FolderDateTimeOperator 参数设置计算运算符。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此参数处理通配符,并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

输出

IResultObject

备注

有关此返回对象及其属性的信息,请参阅SMS_TaskSequence_FolderConditionExpression WMI 类