Share via

Remove-CMCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

Remova uma regra de associação direta de um dispositivo ou conjunto de usuários.

Syntax

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

Use este cmdlet para remover uma regra de associação direta de um dispositivo ou conjunto de usuários. Uma regra de associação direta permite que você escolha explicitamente os membros da coleção. As coleções padrão não têm regras de associação diretas. 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 direta de uma coleção, o recurso pode não ser mais um membro da coleção. Essa ação pode fazer com que qualquer implantação de software ou configuração não se aplique ao recurso.

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

Este exemplo usa a variável Windows de ambiente ComputerName para removê-lo da coleção chamada Test Devices. Ele usa o parâmetro Force para não solicitar confirmação.

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

Parâmetros

-CollectionId

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

Type:String
Aliases:Id
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique o nome da coleção com a regra direta a ser removido.

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:None
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 de coleção com a regra direta a ser removido. Para obter esse objeto, use os cmdlets Get-CMCollection, Get-CMDeviceCollectionou Get-CMUserCollection.

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Resource

Especifique uma matriz de objetos de recurso a ser removido da coleção. Para obter esse objeto, use os cmdlets Get-CMResource, Get-CMDeviceou Get-CMUser.

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

-ResourceId

Especifique uma matriz de IDs de recurso a ser removido da coleção. Esse valor é a propriedade ResourceId da classe SMS_Resource. Por exemplo, "33555693".

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

-ResourceName

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

Type:String[]
Aliases:ResourceNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 usuários.