Compartilhar via

Remove-CMCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

Remova uma regra de associação direta de um dispositivo ou coleção de utilizadores.

Sintaxe

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilize este cmdlet para remover uma regra de associação direta de um dispositivo ou coleção de utilizadores. Uma regra de associação direta permite-lhe escolher explicitamente os membros da coleção. As coleções predefinidas não têm regras de associação direta. 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 direta de uma coleção, o recurso pode já não ser membro da coleção. Esta ação pode fazer com que qualquer implementação de software ou configuração não se aplique ao recurso.

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 o computador local de uma coleção de dispositivos de teste

Este exemplo utiliza a variável de ambiente do Windows ComputerName para removê-la da coleção denominada Dispositivos de Teste. Utiliza o parâmetro Force para não pedir confirmação.

Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -Force

Parâmetros

-CollectionId

Especifique o ID da coleção com a regra direta a remover. Por exemplo, "XYZ0003F".

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 com a regra direta a remover.

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:None
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 de coleção com a regra direta a remover. Para obter este objeto, utilize os cmdlets Get-CMCollection, Get-CMDeviceCollection 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

-Resource

Especifique uma matriz de objetos de recursos a remover da coleção. Para obter este objeto, utilize os cmdlets Get-CMResource, Get-CMDevice ou Get-CMUser .

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 de recursos a remover da coleção. Este valor é a propriedade ResourceId da classe SMS_Resource. Por exemplo, "33555693".

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

-ResourceName

Especifique uma matriz de nomes de recursos a remover da coleção.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Observações

Este cmdlet é semelhante a Remove-CMDeviceCollectionDirectMembershipRule e Remove-CMUserCollectionDirectMembershipRule, que são específicos do tipo de coleção. Este cmdlet funciona com coleções de dispositivos ou utilizadores.