Share via


Get-CMDeviceCollectionQueryMembershipRule

Obter uma regra de associação de consulta para uma coleção de dispositivos.

Syntax

Get-CMDeviceCollectionQueryMembershipRule
   -CollectionName <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMDeviceCollectionQueryMembershipRule
   -CollectionId <String>
   [-RuleName <String>]
   [<CommonParameters>]
Get-CMDeviceCollectionQueryMembershipRule
   -InputObject <IResultObject>
   [-RuleName <String>]
   [<CommonParameters>]

Description

Use este cmdlet para obter uma ou mais regras de associação de consulta para 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. Para obter mais informações, consulte Como criar coleções no Configuration Manager.

Para obter mais informações sobre regras de associação, consulte Introdução a 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: Obter todas as regras de associação de consulta para a coleção All Systems

Este comando obtém as regras de associação de consulta da coleção de dispositivos padrão chamada All Systems.

Get-CMDeviceCollectionQueryMembershipRule -CollectionName "All Systems"

Exemplo 2: Exibir a expressão de consulta para uma regra na coleção All Systems

Este comando obtém a regra de associação de consulta chamada All Systems da coleção All Systems e retorna a expressão de consulta.

Get-CMDeviceCollectionQueryMembershipRule -CollectionId "SMS00001" -RuleName "All Systems" | Select-Object QueryExpression

Parâmetros

-CollectionId

Especifique a ID do conjunto de dispositivos para obter a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 ou SMS00001 .

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

-CollectionName

Especifique o nome da coleção de dispositivos para obter a regra.

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

-InputObject

Especifique um objeto para que a coleção de dispositivos receba 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

-RuleName

Especifique o nome da regra de consulta a ser retirada da coleção.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object