Get-CMCollectionExcludeMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

Get-CMCollectionExcludeMembershipRule
   -CollectionName <String>
   [-ExcludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -CollectionId <String>
   [-ExcludeCollectionName <String>]
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [<CommonParameters>]
Get-CMCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   [-ExcludeCollectionName <String>]
   [<CommonParameters>]

Description

Utilize este cmdlet para obter uma ou mais regras de exclusão de associação para uma coleção de dispositivos ou utilizadores. Uma regra de exclusão de associação exclui os membros de outra coleção das coleções onde a regra é aplicada.

O Configuration Manager atualiza dinamicamente a associação da coleção com base numa agenda se a associação da coleção excluída for alterada.

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 as regras de exclusão de associação para uma coleção

Este comando obtém as regras que excluem os membros da coleção com o ID SMSDM001 da coleção com o ID XYZ00012.

Get-CMCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "SMSDM001"

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 têm regras de exclusão de associação, 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

-ExcludeCollection

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

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

-ExcludeCollectionId

Especifique o ID da coleção excluída para obter a regra. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Pode excluir coleções predefinidas, para que este valor possa começar com o código do site ou SMS.

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

-ExcludeCollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Observações

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