Parâmetros de filtro de entrada

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

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

Incluir e excluir parâmetros

Os Include Exclude parâmetros e identificam os objetos incluídos ou excluídos do conjunto de objetos de entrada passados para o cmdlet . Use esses parâmetros quando o filtro puder ser expresso na linguagem curinga padrão. (Para obter mais informações sobre caracteres curinga, consulte Suporte a curingas em parâmetros de cmdlet.) O Include parâmetro inclui todos os objetos cujos nomes corresponderem ao filtro de inclusão. O Exclude parâmetro exclui todos os objetos cujos nomes corresponderem ao filtro.

Parâmetro filter

O Filter parâmetro especifica um filtro que não é expresso na linguagem curinga padrão. Por exemplo, ADSI (Interfaces de Serviço do Active Directory) ou SQL filtros podem ser passados para o cmdlet por meio de seu Filter parâmetro. Nos cmdlets fornecidos pelo Windows PowerShell, esses filtros são especificados pelos provedores Windows PowerShell que usam o cmdlet para acessar um armazenamento de dados. Cada provedor normalmente define seu próprio filtro.

Filtragem se nenhum conjunto de objetos de entrada for especificado

Se nenhum conjunto de objetos de entrada for especificado, isso normalmente significa filtrar em relação a todos os objetos. Para obter mais informações, consulteGet-Process.

Consulte Também

Escrevendo um Cmdlet do Windows PowerShell