2025-11-28 00:35:46 +09:00

2.9 KiB

Windows PowerShell StopProcessSample04 Sample

This sample shows how to declare parameter sets, the input object, and how to specify the default parameter set to use. This cmdlet stops processes running on the local computer.

Sample Objectives

This sample demonstrates the following:

  1. Declaring a cmdlet class that derives from PSCmdlet
  2. Declaring cmdlet parameters and parameter aliases.
  3. Specifying positions for parameters.
  4. Specifying that the parameters can accept an object from the pipeline or accept a value from a property of an object that has the same name as the parameter.
  5. Specifying parameter sets.
  6. Handling errors and exceptions.
  7. sing the ShouldProcess and ShouldContinue methods.
  8. Implementing the Force and PassThru parameters.
  9. Declaring aliases and wildcard support.
  10. Implementing user notifications using WriteWarning, WriteVerbose, and WriteDebug.
  11. Using InputObject.

Windows PowerShell

cmdlet

ShouldProcess

ShouldContinue

WriteWarning

WriteVerbose

WriteDebug

Operating system requirements

Client

Windows 8.1

Server

Windows Server 2012 R2

Build the sample

  1. Start Microsoft Visual Studio and select File > Open > Project/Solution.

  2. Go to the directory named for the sample, and double-click the Visual Studio Solution (.sln) file.

  3. Press F7 or use Build > Build Solution to build the sample.

    The library will be built in the default \bin or \bin\Debug directory.

Run the sample

  1. Store the assembly in the following module folder: [user]/Documents/WindowsPowerShell/Modules/StopProcessSample04
  2. Start Windows PowerShell.
  3. Run the following command: Import-Module StopProcessSample04 (This command loads the assembly into Windows PowerShell.)
  4. Type the following command to run the cmdlet: Stop-Proc <process name>