Input Filter Parameters (Parâmetros de Filtro de Entrada)

Um cmdlet pode Filter Include definir, e Exclude parâmetros que filtram o conjunto de objetos de entrada que o cmdlet afeta.

Normalmente, o conjunto de objetos de entrada é especificado por um InputObject Path , ou Name parâmetro. Por exemplo, um cmdlet pode ter um Path parâmetro que aceita vários caminhos usando caracteres wildcard, e cada caminho aponta para um objeto de entrada. Usados em conjunto, os Filter , e Include os Exclude parâmetros qualificam ainda mais os caminhos em que o cmdlet trabalha cada vez que é invocado.

Incluir e Excluir Parâmetros

Os Include Exclude parâmetros e parâmetros identificam os objetos incluídos ou excluídos do conjunto de objetos de entrada passados para o cmdlet. Utilize estes parâmetros quando o filtro pode ser expresso no idioma wildcard padrão. (Para obter mais informações sobre caracteres wildcard, consulte Wildcards de suporte em parâmetros de cmdlet.) O Include parâmetro inclui todos os objetos cujos nomes correspondem ao filtro de inclusão. O Exclude parâmetro exclui todos os objetos cujos nomes correspondem ao filtro.

Parâmetro de filtro

O Filter parâmetro especifica um filtro que não é expresso na linguagem wildcard padrão. Por exemplo, as Interfaces de Serviço de Diretório Ativo (ADSI) ou SQL filtros podem ser passados para o cmdlet através do seu Filter parâmetro. Nos cmdlets fornecidos pela Windows PowerShell, estes filtros são especificados pelos fornecedores de Windows PowerShell que utilizam o cmdlet para aceder a uma loja de dados. Cada fornecedor normalmente define o seu próprio filtro.

Filtragem se não for especificado nenhum conjunto de objetos de entrada

Se não for especificado nenhum conjunto de objetos de entrada, isto significa normalmente filtrar contra todos os objetos. Para mais informações, consulteo Get-Process.

Consulte também

Writing a Windows PowerShell Cmdlet (Escrever um Cmdlet do Windows PowerShell)