Share via

Get-CMCollectionQueryMembershipRule

  • Referência
Módulo:
ConfigurationManager

Obtenha uma regra de associação de consulta para um dispositivo ou coleção de usuários.

Syntax

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

Description

Use este cmdlet para obter uma ou mais regras de associação de consulta para um dispositivo ou coleção de usuários. Uma regra de consulta permite atualizar dinamicamente a associação de uma coleção com base em uma consulta que é executada em uma agenda. 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 em Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: obter todas as regras de associação de consulta para a coleção All Systems

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

Get-CMCollectionQueryMembershipRule -CollectionName "All Systems"

Exemplo 2: exibir a expressão de consulta para uma regra na coleção Todos os Usuários

Esse comando obtém a regra de associação de consulta chamada Todos os Usuários da coleção Todos os Usuários e retorna a expressão de consulta.

Get-CMCollectionQueryMembershipRule -CollectionId "SMS00002" -RuleName "All Users" | Select-Object QueryExpression

Parâmetros

-CollectionId

Especifique a ID da coleção para obter a regra. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012 ou SMS00001.

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

-CollectionName

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

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

-InputObject

Especifique um objeto para a coleção obter a regra. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RuleName

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Observações

Esse cmdlet é semelhante a Get-CMDeviceCollectionQueryMembershipRule e Get-CMUserCollectionQueryMembershipRule, que são específicos para o tipo de coleção. Esse cmdlet funciona com conjuntos de dispositivos ou usuários.