Add-CMDeviceCollectionQueryMembershipRule
Adicione uma regra de associação de consulta a uma coleção de dispositivos.
Syntax
Add-CMDeviceCollectionQueryMembershipRule
-CollectionId <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
-CollectionName <String>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMDeviceCollectionQueryMembershipRule
-InputObject <IResultObject>
[-PassThru]
-QueryExpression <String>
-RuleName <String>
[-ValidateQueryHasResult]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para adicionar uma regra de associação de consulta a uma coleção de dispositivos.
Uma regra de consulta permite atualizar dinamicamente a associação de uma coleção com base em uma consulta que é executado em um cronograma.
Não é possível adicionar regras de associação a coleções padrão. Qualquer coleção que você direcionar deve ter uma ID que comece com o código do site, não SMS
.
Para obter mais informações, consulte Como criar coleções no Configuration Manager.
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: Adicionar uma regra de associação de consulta
Este exemplo armazena primeiro a instrução WQL (WQL) na variável wql. O próximo comando adiciona uma regra de associação chamada TPM à coleção de dispositivos Windows 10 dispositivos. O parâmetro QueryExpression usa a variável wql e especifica a consulta que define a regra de associação.
$wql = "select SMS_R_System.ResourceId, SMS_R_System.ResourceType, SMS_R_System.Name, SMS_R_System.SMSUniqueIdentifier, SMS_R_System.ResourceDomainORWorkgroup, SMS_R_System.Client from SMS_R_System inner join SMS_G_System_TPM on SMS_G_System_TPM.ResourceID = SMS_R_System.ResourceId"
Add-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -QueryExpression $wql -RuleName "TPM"
Parâmetros
-CollectionId
Especifique a ID do conjunto de dispositivos para adicionar a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012
. Como você não pode adicionar regras de associação a coleções padrão, essa ID começa com o código do site e não SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique o nome da coleção de dispositivos para adicionar a regra.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-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 |
-InputObject
Especifique um objeto para a coleção de dispositivos para adicionar a regra. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMDeviceCollection.
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryExpression
Especifique a expressão WQL (WQL) que o site usa para atualizar o conjunto de dispositivos.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RuleName
Especifique o nome da regra de consulta a ser acrescentada à coleção.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValidateQueryHasResult
Adicione esse parâmetro para testar a expressão de consulta antes de adicionar a regra. Quando o cmdlet é executado com esse parâmetro, se a expressão de consulta não tiver resultados, o cmdlet retornará a seguinte mensagem de erro: Nesse caso, a consulta não será adicionada à No object corresponds to the specified parameters.
coleção.
Se você sabe que a consulta retorna resultados zero no momento, mas ainda deseja adicionar a regra, não use esse parâmetro.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object