Share via

Add-CMDeviceCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

Syntax

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para adicionar uma regra de associação direta a uma coleção de dispositivos. Uma regra de associação direta permite que você escolha explicitamente os membros da coleção de dispositivos. 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 . 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 direta

Este comando adiciona uma regra de associação direta à coleção de dispositivos com iD XYZ00056. Ele adiciona o recurso com ID 16777219 à coleção.

Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219

Exemplo 2: Adicionar uma regra de associação direta usando o pipeline

Este comando usa primeiro o cmdlet Get-CMCollection para obter o objeto da coleção chamado testCollection. Em seguida, ele usa o operador de pipeline para passar o objeto para o cmdlet Add-CMDeviceCollectionDirectMembershipRule, que adiciona a regra de associação direta ao objeto da coleção de dispositivos. Ele adiciona o dispositivo com ID 16777219 à coleção.

Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219

Parâmetros

-CollectionId

Especifique a ID do conjunto de dispositivos para adicionar a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 . Como você não pode adicionar regras de associação a coleções padrão, essa ID começa com o código do site e não SMS .

Type:String
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
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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
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

-Resource

Especifique uma matriz de objetos de recurso para adicionar à coleção de dispositivos com essa regra de associação direta. Para obter esse objeto, use o cmdlet Get-CMResource ou o cmdlet Get-CMDevice com o -Resource parâmetro.

Type:IResultObject[]
Aliases:Resources
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

Especifique uma matriz de IDs dos recursos a adicionar à coleção de dispositivos com essa regra de associação direta. Esse valor é a propriedade ResourceID, por exemplo 16777219 .

Type:Int32[]
Aliases:ResourceIds
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