Share via

Get-CMCollectionIncludeMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

Syntax

Get-CMCollectionIncludeMembershipRule
   -CollectionName <String>
   [-IncludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -CollectionId <String>
   [-IncludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   [-IncludeCollectionName <String>]
   [<CommonParameters>]

Description

Use este cmdlet para obter uma ou mais regras de associação para um dispositivo ou conjunto de usuários. Uma regra de associação include inclui os membros de outra coleção para as coleções em que a regra é aplicada.

O Configuration Manager atualiza dinamicamente a associação da coleção em um cronograma se a associação da coleção incluída mudar.

Para obter mais informações, consulte Como criar 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 incluem

Este comando obtém todas as regras de associação para a coleção chamada Device.

Get-CMCollectionIncludeMembershipRule -CollectionName "Device"

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

Este comando usa primeiro o Get-CMCollection para obter o objeto da coleção chamado Users. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet Get-CMCollectionIncludeMembershipRule, que obtém todas as regras de associação para o objeto de coleção.

Get-CMCollection -Name "Users" | Get-CMCollectionIncludeMembershipRule

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 incluem regras de associação, essa ID começa com o código do site e não SMS .

Type:String
Aliases:Id
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-IncludeCollection

Especifique um objeto para a coleção incluída para obter a regra. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollectionou Get-CMUserCollection.

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

-IncludeCollectionId

Especifique a ID da coleção incluída para obter a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 . Você pode incluir coleções padrão, para que esse valor possa começar com o código do site ou SMS .

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

-IncludeCollectionName

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

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

-InputObject

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Observações

Este cmdlet é semelhante a Get-CMDeviceCollectionIncludeMembershipRule e Get-CMUserCollectionIncludeMembershipRule, que são específicos do tipo de coleção. Este cmdlet funciona com coleções de dispositivos ou usuários.