Add-CMDeviceCollectionIncludeMembershipRule

Módulo:

ConfigurationManager

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

Syntax

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para adicionar uma regra de associação include a uma coleção de dispositivos. Uma regra de associação include inclui os membros de outra coleção para o conjunto de dispositivos onde a regra é aplicada.

Não é possível adicionar regras de associação a coleções padrão. Qualquer coleção que você direcionar deve ter uma ID que comece com o código do site, não SMS . Você pode incluir uma coleção padrão, para que a ID de uma coleção incluída possa começar com SMS .

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

Quando você adiciona uma regra de associação include a uma coleção, os recursos podem se tornar membros da coleção. Essa ação pode fazer com que qualquer implantação de software ou configuração se aplique a dispositivos na coleção incluída.

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: Adicionar uma regra de associação incluir

Este comando adiciona a coleção de dispositivos chamada All Systems com uma regra de associação include. A regra é adicionada à coleção de dispositivos chamada Device.

Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"

Exemplo 2: Adicionar uma regra de associação incluir a uma coleção usando o pipeline

Este comando primeiro usa o cmdlet Get-CMCollection para obter o objeto da coleção de destino chamado Device. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet Add-CMDeviceCollectionIncludeMembershipRule, que adiciona uma regra de associação include para a coleção de dispositivos chamada All Systems.

Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"

Parâmetros

-CollectionId

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

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

-IncludeCollection

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

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Links Relacionados

• Get-CMDeviceCollectionIncludeMembershipRule
• Remove-CMDeviceCollectionIncludeMembershipRule
• Get-CMCollection
• Get-CMDeviceCollection
• Add-CMUserCollectionIncludeMembershipRule
• Como criar coleções no Configuration Manager