Share via

New-CMDetectionClauseRegistryKey

  • Referência
Módulo:
ConfigurationManager

Crie uma cláusula de método de detecção para uma chave do Registro.

Syntax

New-CMDetectionClauseRegistryKey
   [-Existence]
   -Hive <RegistryRootKey>
   [-Is64Bit]
   -KeyName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para criar uma cláusula em um método de detecção em um aplicativo. Esta cláusula é uma regra para uma chave do Registro indicar a presença de um aplicativo.

Para detectar um valor do Registro em vez de uma chave, use o cmdlet New-CMDetectionClauseRegistryKeyValue.

Depois de usar esse cmdlet, use um dos cmdlets Add- or Set- para tipos de implantação. Passe esse objeto de cláusula de detecção para os parâmetros AddDetectionClause ou RemoveDetectionClause.

Para agrupar cláusulas de detecção, use o parâmetro GroupDetectionClauses nos cmdlets de tipo de implantação.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Criar várias cláusulas para um tipo de implantação de aplicativo MSI

Este exemplo cria duas cláusulas de arquivo e uma cláusula de Registro e as usa para adicionar um tipo de implantação MSI a um aplicativo.

$cla1=New-CMDetectionClauseFile -FileName "filetest" -PropertyType Size -ExpectedValue 123 -ExpressionOperator IsEquals -Path "C:\" -Value -Is64Bit
$cla2=New-CMDetectionClauseFile -FileName "foldertest" -PropertyType DateCreated -ExpectedValue (Get-Date) -ExpressionOperator LessThan -Path "C:\" -Value
$cla3=New-CMDetectionClauseRegistryKey -Hive ClassesRoot -KeyName "aaa"
$logic1=$cla1.Setting.LogicalName
$logic2=$cla2.Setting.LogicalName
$logic3=$cla3.Setting.LogicalName

Add-CMMsiDeploymentType -AddDetectionClause $cla1,$cla2,$cla3 -ApplicationName "app" -DeploymentTypeName "dt" -InstallCommand "mycommand" -ContentLocation "\\server\sources\Orca.msi" -GroupDetectionClauses $logic1,$logic2 -DetectionClauseConnector {LogicalName=$logic2;Connector="or"},{LogicalName=$logic3;Connector="or"}

Parâmetros

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-Existence

Esse parâmetro está implícito e opcional.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-Hive

Especifique o hive do Registro onde a chave existe. Use o parâmetro KeyName para especificar o nome da chave.

Type:RegistryRootKey
Aliases:RegistryHive
Accepted values:ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Is64Bit

Adicione esse parâmetro para indicar que essa chave do Registro está associada a um aplicativo de 32 bits em sistemas de 64 bits.

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

-KeyName

Especifique o nome da chave do Registro que deve existir para indicar a presença deste aplicativo. Use o parâmetro Hive para especificar o hive do Registro onde essa chave deve existir.

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

Entradas

Nenhum

Saídas

System.Object