Compartilhar via

Get-CMCollectionQueryMembershipRule

  • Referência
Módulo:
ConfigurationManager

Obtenha uma regra de associação de consulta para um dispositivo ou coleção de utilizadores.

Sintaxe

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

Description

Utilize este cmdlet para obter uma ou mais regras de associação a consultas para um dispositivo ou coleção de utilizadores. Uma regra de consulta permite-lhe atualizar dinamicamente a associação de uma coleção com base numa consulta que é executada com base numa agenda. Para obter mais informações, veja Como criar coleções no Configuration Manager.

Para obter mais informações sobre as regras de associação, veja Introdução às coleções no Configuration Manager.

Observação

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

Exemplos

Exemplo 1: Obter todas as regras de associação de consultas para a coleção Todos os Sistemas

Este comando obtém as regras de associação de consultas da coleção de dispositivos predefinida denominada Todos os Sistemas.

Get-CMCollectionQueryMembershipRule -CollectionName "All Systems"

Exemplo 2: Ver a expressão de consulta de uma regra na coleção Todos os Utilizadores

Este comando obtém a regra de associação de consulta denominada Todos os Utilizadores da coleção Todos os Utilizadores e devolve a expressão de consulta.

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

Parâmetros

-CollectionId

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

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

-CollectionName

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

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

-InputObject

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

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

-RuleName

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

Tipo:String
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

Observações

Este cmdlet é semelhante a Get-CMDeviceCollectionQueryMembershipRule e Get-CMUserCollectionQueryMembershipRule, que são específicos do tipo de coleção. Este cmdlet funciona com coleções de dispositivos ou utilizadores.