Partilhar via

Add-CMDeviceCollectionExcludeMembershipRule

  • Referência
Módulo:
ConfigurationManager

Adicione uma regra de exclusão de associação a uma coleção de dispositivos.

Sintaxe

Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Não pode adicionar regras de associação a coleções predefinidas. Qualquer coleção que tenha como destino deve ter um ID que comece com o código do site, não SMScom . Pode excluir uma coleção predefinida, para que o ID de uma coleção excluída possa começar com SMS.

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

Quando adiciona uma regra de exclusão de associação a uma coleção, um recurso pode já não ser membro da coleção de dispositivos. Esta ação pode fazer com que qualquer implementação de software ou configuração não se aplique a um dispositivo.

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: Adicionar uma regra de exclusão de coleção a uma coleção de dispositivos

Este comando exclui os membros da coleção predefinida Todos os Dispositivos Móveis , que tem o ID SMSDM001, do ID da coleção de dispositivos XYZ00012.

Add-CMDeviceCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "SMSDM001"

Parâmetros

-CollectionId

Especifique o ID da coleção de dispositivos para adicionar 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 de dispositivos para adicionar 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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExcludeCollection

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

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 adicionar 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 adicionar a regra.

Tipo:String
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 de dispositivos para adicionar a regra. Para obter este objeto, utilize os cmdlets Get-CMCollection ou Get-CMDeviceCollection .

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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object