Share via

Remove-CMDeviceCollectionQueryMembershipRule

  • Referência
Módulo:
ConfigurationManager

Remova uma regra de associação de consulta de uma coleção de dispositivos.

Syntax

Remove-CMDeviceCollectionQueryMembershipRule
      -InputObject <IResultObject>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionQueryMembershipRule
      -CollectionName <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionQueryMembershipRule
      -CollectionId <String>
      -RuleName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use este cmdlet para remover uma regra de associação de consulta de uma coleção de dispositivos. Uma regra de consulta permite atualizar dinamicamente a associação de uma coleção com base em uma consulta que é executado em um cronograma. Não é possível remover as regras de consulta das 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.

Quando você remove uma regra de associação de consulta de uma coleção, vários recursos podem não ser mais membros da coleção. Essa ação pode fazer com que qualquer implantação de software ou configuração não se aplique aos dispositivos.

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: Remover as regras de associação de consulta para um conjunto de dispositivos

Este comando remove a regra de associação de consulta chamada TPM da coleção de dispositivos Windows 10 dispositivos.

Remove-CMDeviceCollectionQueryMembershipRule -CollectionName "Windows 10 devices" -RuleName "TPM" -Force

Parâmetros

-CollectionId

Especifique a ID do conjunto de dispositivos para remover a regra. Esse valor é a propriedade CollectionID, por exemplo, XYZ00012 . Como você não pode remover as regras de consulta de coleções padrã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 remover 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

-Força

Execute o comando sem pedir confirmação.

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

-InputObject

Especifique um objeto para que a coleção de dispositivos remova 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

-RuleName

Especifique o nome da regra de consulta a ser removido da coleção.

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