Add-CMDeviceCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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

Utilize este cmdlet para adicionar uma regra de associação direta a uma coleção de dispositivos. Uma regra de associação direta permite-lhe escolher explicitamente os membros da coleção de dispositivos. 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 . 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 associação direta

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

Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219

Exemplo 2: adicionar uma regra de associação direta com o pipeline

Este comando utiliza primeiro o cmdlet Get-CMCollection para obter o objeto de coleção denominado testCollection. Em seguida, utiliza o operador de pipeline para transmitir o objeto ao cmdlet Add-CMDeviceCollectionDirectMembershipRule , que adiciona a regra de associação direta ao objeto de coleção de dispositivos. Adiciona o dispositivo com o ID 16777219 à coleção.

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

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 não pode adicionar regras de associação a coleções predefinidas, este ID começa com o código do site e não SMScom .

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

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

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

-Resource

Especifique uma matriz de objetos de recursos a adicionar à coleção de dispositivos com esta regra de associação direta. Para obter este objeto, utilize o cmdlet Get-CMResource ou o cmdlet Get-CMDevice com o -Resource parâmetro .

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

-ResourceId

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

Tipo:Int32[]
Aliases:ResourceIds
Cargo:Named
Valor padrão:None
Obrigatório:True
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