Compartilhar via

Remove-CMDeviceCollectionDirectMembershipRule

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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

Description

Use esse cmdlet para remover uma regra de associação direta de uma coleção de dispositivos. Uma regra de associação direta permite que você escolha explicitamente os membros da coleção de dispositivos. Coleções padrão não têm regras de associação diretas. Qualquer coleção direcionada 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 dispositivo.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: remover uma regra de associação direta de uma coleção de dispositivos

Esse comando remove a regra de associação direta para o recurso com a ID de 2097152004 da coleção chamada Dispositivos 01. Especificar o parâmetro Force indica que o usuário não é solicitado antes que a regra seja removida.

Remove-CMDeviceCollectionDirectMembershipRule -CollectionName "Devices 01" -ResourceId "2097152004" -Force

Parâmetros

-CollectionId

Especifique a ID de uma coleção de dispositivos com a regra direta a ser removida. 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 de dispositivos com a regra direta a ser removida.

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 de coleção de dispositivos com a regra direta a ser removida. Para obter esse objeto, use 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

-Resource

Especifique uma matriz de objetos de dispositivo para remover sua regra de associação direta da coleção de dispositivos. Para obter esse objeto, use os cmdlets Get-CMResource ou Get-CMDevice .

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 para remover as regras de associação direta da coleção de dispositivos. Esse 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 para remover as regras de associação direta da coleção de dispositivos.

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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object