Compartilhar via

Get-CMCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

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

Utilize este cmdlet para obter uma ou mais regras de associação direta para um dispositivo ou coleção de utilizadores. Uma regra de associação direta permite-lhe escolher explicitamente os membros da coleção de dispositivos. As coleções predefinidas não têm regras de associação direta. Qualquer coleção que tenha como destino deve ter um ID que comece com o código do site, não SMScom . Para obter mais informações, veja Como criar 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 direta para uma coleção por nome

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

Get-CMCollectionDirectMembershipRule -CollectionName "Device01"

Exemplo 2: obter todas as regras de associação direta com o pipeline

Este comando utiliza o cmdlet Get-CMCollection para obter o objeto de coleção denominado User02. Em seguida, utiliza o operador de pipeline para passar o objeto para o cmdlet Get-CMCollectionDirectMembershipRule .

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

Parâmetros

-CollectionId

Especifique o ID da coleção para obter a regra. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Uma vez que as coleções predefinidas não podem ter regras de associação direta, este 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 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

-Resource

Especifique um recurso, dispositivo ou objeto de utilizador para obter a regra de associação direta da coleção. Para obter este objeto, utilize 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 o ID do recurso para obter a regra de associação direta da coleção. Este 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 utilizador para obter a 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

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