Add-CMCIDetectionMethod

  • Referência
Módulo:
ConfigurationManager

Especifique como o cliente deteta uma aplicação.

Sintaxe

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>]

Description

Este cmdlet especifica como o cliente deteta uma aplicação no dispositivo. Existem três métodos de deteção: deteção do Windows Installer, deteção por um tipo de aplicação e implementação específico e um script personalizado para detetar a aplicação.

Exemplos

Exemplo 1: deteção do Windows Installer

$ci = Get-CMConfigurationItem -Name "testCI"

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

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

Exemplo 2: aplicação e tipo de implementação específicos

$ci = Get-CMConfigurationItem -Name "testCI"

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

Exemplo 3: Deteção de scripts personalizados

$ci = Get-CMConfigurationItem -Name "testCI"

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

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

Parâmetros

-ApplicationName

Quando definir DetectionOption como DeploymentType, utilize este parâmetro para especificar o nome de uma aplicação do Configuration Manager. Utilize este parâmetro com DeploymentTypeID.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentTypeId

Quando definir DetectionOption como DeploymentType, utilize este parâmetro para especificar o ID do tipo de implementação da aplicação Configuration Manager. Utilize este parâmetro com ApplicationName.

Para obter o ID do tipo de implementação, utilize o cmdlet Get-CMDeploymentType e referencie a propriedade CI_ID .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DetectionOption

Especifique o método de deteção a utilizar.

Tipo:ApplicationDetectionMethod
Valores aceitos:None, Msi, Script, DeploymentType
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de item de configuração para um tipo de implementação de aplicação. Para obter este objeto, utilize Get-CMConfigurationItem.

Tipo:IResultObject
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IsPerUserInstallation

Defina este parâmetro como $true para especificar que está instalado por utilizador.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MsiFilePath

Quando definir DetectionOption como Msi, utilize este parâmetro para especificar o caminho para o ficheiro do Windows Installer.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScriptFile

Quando definir DetectionOption como Script, utilize este parâmetro para especificar o caminho para o script. Utilize este parâmetro com ScriptLanguage.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScriptLanguage

Quando definir DetectionOption como Script, utilize este parâmetro para especificar o idioma do script. Utilize este parâmetro com ScriptFile e ScriptText.

Tipo:ScriptingLanguage
Aliases:ScriptType
Valores aceitos:PowerShell, VBScript, JScript
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScriptText

Quando definir DetectionOption como Script, utilize este parâmetro para especificar o texto do script. Utilize este parâmetro com ScriptLanguage.

Tipo:String
Aliases:ScriptContent
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object