Remove-CMDeviceCollectionIncludeMembershipRule

  • Referência
Módulo:
ConfigurationManager

Remover uma regra de inclusão de associação de uma coleção de dispositivos.

Sintaxe

Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionName <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -CollectionId <String>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollection <IResultObject>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionId <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionIncludeMembershipRule
      -InputObject <IResultObject>
      -IncludeCollectionName <String>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilize este cmdlet para remover uma regra de inclusão de associação de uma coleção de dispositivos. Uma regra de inclusão de associação inclui os membros de outra coleção nas coleções de dispositivos onde a regra é aplicada.

Para obter mais informações, veja Como criar coleções no Configuration Manager.

Quando remove uma regra de inclusão de associação a uma coleção, um recurso pode já não ser membro da coleção de dispositivos. Esta ação pode fazer com que qualquer implementação de software ou configuração não se aplique a um dispositivo.

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 inclusão de associação

Este comando remove a regra de inclusão de associação para a coleção Todos os Sistemas da coleção de dispositivos denominada Dispositivo. Especificar o parâmetro Force indica que a regra de associação é removida sem pedir.

Remove-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems" -Force

Exemplo 2: Remover uma regra de inclusão de associação com o pipeline

Este comando utiliza primeiro o cmdlet Get-CMCollection para obter o objeto de coleção de dispositivos denominado Dispositivo. Em seguida, utiliza o operador de pipeline para passar o objeto para o cmdlet Remove-CMDeviceCollectionIncludeMembershipRule .

Get-CMCollection -Name "Device" | Remove-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems" -Force

Parâmetros

-CollectionId

Especifique o ID da coleção de dispositivos para remover a regra. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Uma vez que as coleções predefinidas não incluem regras de associação, 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 dispositivos 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

Força o comando a ser executado sem pedir a confirmação do utilizador.

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

-IncludeCollection

Especifique um objeto para a coleção incluída para remover a regra. Para obter este objeto, utilize os cmdlets Get-CMCollection ou Get-CMDeviceCollection .

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

-IncludeCollectionId

Especifique o ID da coleção incluída para remover a regra. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Pode incluir coleções predefinidas, para que este valor possa começar com o código do site ou SMS.

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

-IncludeCollectionName

Especifique o nome da coleção incluída para remover a regra.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
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-CMDeviceCollection .

Tipo:IResultObject
Aliases:Collection
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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