Compartilhar via

Get-CMCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-ResourceName <String>]
   [<CommonParameters>]

Description

Use este cmdlet para obter uma ou mais regras de associação diretas para um dispositivo ou coleção de usuários. Uma regra de associação direta permite que você escolha explicitamente os membros da coleção de dispositivos. Coleções padrão não têm regras de associação diretas. Qualquer coleção direcionada 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 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 diretas para uma coleção por nome

Esse comando obtém as regras de associação direta para a coleção chamada Device01.

Get-CMCollectionDirectMembershipRule -CollectionName "Device01"

Exemplo 2: Obter todas as regras de associação direta usando o pipeline

Esse comando usa o cmdlet Get-CMCollection para obter o objeto de coleção chamado User02. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet Get-CMCollectionDirectMembershipRule .

Get-CMCollection -Name "User02" | Get-CMCollectionDirectMembershipRule

Parâmetros

-CollectionId

Especifique a ID da coleção para obter a regra. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012. Como as coleções padrão não podem ter regras de associação diretas, essa ID começa com o código do site e não SMScom .

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 esse objeto, use 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

-Resource

Especifique um recurso, dispositivo ou objeto de usuário para obter sua regra de associação direta da coleção. Para obter esse objeto, use os cmdlets Get-CMResource, Get-CMDevice ou Get-CMUser .

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

-ResourceId

Especifique a ID do recurso para obter sua regra de associação direta da coleção. Esse valor é a propriedade ResourceID , por exemplo 16777219.

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

-ResourceName

Especifique o nome do dispositivo ou do usuário para obter sua regra de associação direta da coleção.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Observações

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