Remove-CMUserCollectionQueryMembershipRule

  • Referência
Módulo:
ConfigurationManager

Remover uma regra de associação de consulta de uma coleção de utilizadores.

Sintaxe

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

Description

Utilize este cmdlet para remover uma regra de associação de consulta de uma coleção de utilizadores. Uma regra de consulta permite-lhe atualizar dinamicamente a associação de uma coleção com base numa consulta que é executada com base numa agenda. Não pode remover regras de consulta das 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.

Quando remove uma regra de associação de consulta de uma coleção, vários recursos podem já não ser membros da coleção. Esta ação pode fazer com que qualquer implementação de software ou configuração não se aplique aos utilizadores.

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: Remover uma regra de uma coleção com o nome da coleção

Este comando remove a regra denominada Utilizadores Remotos por Domínio da coleção denominada Utilizadores Remotos.

Remove-CMUserCollectionQueryMembershipRule -CollectionName "Remote Users" -RuleName "Remote Users by Domain"

Parâmetros

-CollectionId

Especifique o ID da coleção de utilizadores para remover a regra. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Uma vez que não pode remover as regras de consulta das coleções predefinidas, este ID começa com o código do site e não SMScom .

Tipo:String
Aliases:Id
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 utilizadores para remover a regra.

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

-Force

Execute o comando sem pedir confirmação.

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 remover a regra. Para obter este objeto, utilize os cmdlets Get-CMCollection ou Get-CMUserCollection .

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

-RuleName

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

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