Add-CMCIDetectionMethod

  • 参考
模块:
ConfigurationManager

指定客户端检测应用程序的方式。

语法

Add-CMCIDetectionMethod
   [-InputObject] <IResultObject>
   -DetectionOption <ApplicationDetectionMethod>
   [-MsiFilePath <String>]
   [-IsPerUserInstallation <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptingLanguage>]
   [-ScriptText <String>]
   [-ApplicationName <String>]
   [-DeploymentTypeId <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

此 cmdlet 指定客户端如何检测设备上的应用程序。 有三种检测方法：Windows Installer 检测、特定应用程序和部署类型的检测，以及用于检测应用程序的自定义脚本。

示例

示例 1：Windows Installer 检测

$ci = Get-CMConfigurationItem -Name "testCI"

$msiFilePath = "C:\tools\CCMTools\Orca.Msi"

$ci | Add-CMCIDetectionMethod -DetectionOption Msi -MsiFilePath $msiFilePath

示例 2：特定应用和部署类型

$ci = Get-CMConfigurationItem -Name "testCI"

$ci | Add-CMCIDetectionMethod -DetectionOption DeploymentType -ApplicationName "testApp" -DeploymentTypeId "392672"

示例 3：自定义脚本检测

$ci = Get-CMConfigurationItem -Name "testCI"

$scriptFile  = "C:\share\testScript.ps1"

$ci | Add-CMCIDetectionMethod -DetectionOption Script -ScriptLanguage PowerShell -ScriptFile $scriptFile

参数

-ApplicationName

将 DetectionOption 设置为 DeploymentType时，使用此参数指定Configuration Manager应用程序的名称。 将此参数与 DeploymentTypeID 一起使用。

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

-Confirm

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

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

-DeploymentTypeId

将 DetectionOption 设置为 DeploymentType时，使用此参数指定Configuration Manager应用程序的部署类型的 ID。 将此参数与 ApplicationName 配合使用。

若要获取部署类型 ID，请使用 Get-CMDeploymentType cmdlet，并引用 CI_ID 属性。

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

-DetectionOption

指定要使用的检测方法。

Type:ApplicationDetectionMethod
Accepted values:None, Msi, Script, DeploymentType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

为应用程序部署类型指定配置项目对象。 若要获取此对象，请使用 Get-CMConfigurationItem。

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IsPerUserInstallation

将此参数设置为 以 $true 指定按用户安装。

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

-MsiFilePath

将 DetectionOption 设置为 Msi时，使用此参数指定 Windows Installer 文件的路径。

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

-PassThru

返回一个 对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-ScriptFile

将 DetectionOption 设置为 Script时，使用此参数指定脚本的路径。 将此参数与 ScriptLanguage 配合使用。

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

-ScriptLanguage

将 DetectionOption 设置为 Script时，使用此参数指定脚本的语言。 将此参数与 ScriptFile 和 ScriptText 一起使用。

Type:ScriptingLanguage
Aliases:ScriptType
Accepted values:PowerShell, VBScript, JScript
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptText

将 DetectionOption 设置为 Script时，使用此参数指定脚本的文本。 将此参数与 ScriptLanguage 配合使用。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object