Share via


Get-CMDeviceCollectionDirectMembershipRule

Obter uma regra de associação direta para uma coleção de dispositivos.

Syntax

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

Description

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

Este comando obtém as regras de associação diretas para a coleção de dispositivos chamada Device01.

Get-CMDeviceCollectionDirectMembershipRule -CollectionName "Device01"

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

Este comando usa o cmdlet Get-CMCollection para obter o objeto da coleção de dispositivos chamado Device02. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet Get-CMDeviceCollectionDirectMembershipRule.

Get-CMCollection -Name "Device02" | Get-CMDeviceCollectionDirectMembershipRule

Parâmetros

-CollectionId

Especifique a ID do conjunto de dispositivos 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 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 de dispositivos para obter a regra.

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

-InputObject

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

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

-Resource

Especifique um objeto device para obter sua regra de associação direta da coleção de dispositivos. Para obter esse objeto, use os cmdlets Get-CMResource ou Get-CMDevice.

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

-ResourceId

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

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

-ResourceName

Especifique o nome do dispositivo para obter sua regra de associação direta da coleção de dispositivos.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object