Partilhar via

Add-CMDeviceCollectionExcludeMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

Syntax

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

Use esse cmdlet para adicionar uma regra de associação de exclusã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 em que a regra é aplicada.

Você não pode adicionar regras de associação a coleções padrão. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS. Você pode excluir uma coleção padrão para que a ID de uma coleção excluída possa começar com SMS.

Configuration Manager atualizará dinamicamente a associação da coleção de dispositivos em um agendamento se a associação da coleção excluída for alterada.

Quando você adiciona uma regra de associação de exclusão a uma coleção, um recurso pode não ser mais um membro da coleção de dispositivos. Essa ação pode fazer com que qualquer implantação de software ou configuração não se aplique a um dispositivo.

Para obter mais informações, consulte Como criar coleções no Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Adicionar uma regra de coleta de exclusão a uma coleção de dispositivos

Esse comando exclui os membros da coleção padrão All Mobile Devices , que tem a ID SMSDM001, da ID da coleção de dispositivos XYZ00012.

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

Parâmetros

-CollectionId

Especifique a ID da coleção de dispositivos para adicionar a regra. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012. Como as coleções padrão não têm regras de associação excluídas, essa ID começa com o código do site e não SMScom .

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

-CollectionName

Especifique o nome da coleção de dispositivos para adicionar a regra.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeCollection

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

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

-ExcludeCollectionId

Especifique a ID da coleção excluída para adicionar a regra. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012. Você pode excluir 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeCollectionName

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

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

-InputObject

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

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object