Como substituir os métodos de processamento de entrada

Esses exemplos mostram como substituir os métodos de processamento de entrada dentro de um cmdlet. Esses métodos são usados para executar as seguintes operações:

• O método System. Management. Automation. cmdlet. BeginProcessing é usado para executar operações de inicialização única que são válidas para todos os objetos processados pelo cmdlet. o tempo de execução do Windows PowerShell chama esse método apenas uma vez.

• O método System. Management. Automation. cmdlet. ProcessRecord é usado para processar os objetos passados para o cmdlet. o tempo de execução de Windows PowerShell chama esse método para cada objeto passado para o cmdlet.

• O método System. Management. Automation. cmdlet. Endprocessor é usado para executar operações de pós-processamento de execução única. o tempo de execução do Windows PowerShell chama esse método apenas uma vez.

Para substituir o método BeginProcessing

• Declare uma substituição protegida do método System. Management. Automation. cmdlet. BeginProcessing .

A classe a seguir imprime uma mensagem de exemplo. Para usar essa classe, altere o verbo e o substantivo no atributo cmdlet, altere o nome da classe para refletir o novo verbo e substantivo e, em seguida, adicione a funcionalidade necessária à substituição do método System. Management. Automation. cmdlet. BeginProcessing .

[Cmdlet(VerbsDiagnostic.Test, "BeginProcessingClass")]
public class TestBeginProcessingClassTemplate : Cmdlet
{
  // Override the BeginProcessing method to add preprocessing
  //operations to the cmdlet.
  protected override void BeginProcessing()
  {
    // Replace the WriteObject method with the logic required
    // by your cmdlet. It is used here to generate the following
    // output:
    // "This is a test of the BeginProcessing template."
    WriteObject("This is a test of the BeginProcessing template.");
  }
}

Para substituir o método ProcessRecord

• Declare uma substituição protegida do método System. Management. Automation. cmdlet. ProcessRecord .

A classe a seguir imprime uma mensagem de exemplo. Para usar essa classe, altere o verbo e o substantivo no atributo cmdlet, altere o nome da classe para refletir o novo verbo e substantivo e, em seguida, adicione a funcionalidade necessária à substituição do método System. Management. Automation. cmdlet. ProcessRecord .

[Cmdlet(VerbsDiagnostic.Test, "ProcessRecordClass")]
public class TestProcessRecordClassTemplate : Cmdlet
{
    // Override the ProcessRecord method to add processing
    //operations to the cmdlet.
    protected override void ProcessRecord()
    {
        // Replace the WriteObject method with the logic required
        // by your cmdlet. It is used here to generate the following
        // output:
        // "This is a test of the ProcessRecord template."
        WriteObject("This is a test of the ProcessRecord template.");
    }
}

Para substituir o método endprocessor

• Declare uma substituição protegida do método System. Management. Automation. cmdlet. Endprocessor .

A classe a seguir imprime um exemplo. Para usar essa classe, altere o verbo e o substantivo no atributo de cmdlet, altere o nome da classe para refletir o novo verbo e substantivo e, em seguida, adicione a funcionalidade necessária à substituição do método System. Management. Automation. cmdlet. Endprocessor .

[Cmdlet(VerbsDiagnostic.Test, "EndProcessingClass")]
public class TestEndProcessingClassTemplate : Cmdlet
{
  // Override the EndProcessing method to add postprocessing
  //operations to the cmdlet.
  protected override void EndProcessing()
  {
    // Replace the WriteObject method with the logic required
    // by your cmdlet. It is used here to generate the following
    // output:
    // "This is a test of the BeginProcessing template."
    WriteObject("This is a test of the EndProcessing template.");
  }
}

Consulte Também

System. Management. Automation. cmdlet. BeginProcessing

Sistema. Management. Automation. cmdlet. endprocessation

System. Management. Automation. cmdlet. ProcessRecord

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