Skip to main content

ByValue for Specific Objects

This is post 5 of 7 in this series.
Many cmdlets accept pipeline input ByValue, but only for very specific objects.  After all, do you think it would be wise to do this?

PS C:\> Get-Process | New-Mailbox

Probably not. We are going to see if this command will work.

PS C:\> Get-Service -Name "Bits" | Stop-Service

First off, let’s get the objects TypeName that is produce by the left hand side of the command.

PS C:\> Get-Service -Name "Bits" | GM


   TypeName: System.ServiceProcess.ServiceController

Name                      MemberType    Definition                                        
----                      ----------    ----------                                        
Name                      AliasProperty Name = ServiceName                                
RequiredServices          AliasProperty RequiredServices = ServicesDependedOn              
Disposed                  Event         System.EventHandler Disposed(System.Object, Syst..

We can see that the object is of type ServiceController. Next, we need to see if any parameter of Stop-Service will accept input from the PowerShell pipeline.

PS C:\> Get-help Stop-Service -Parameter *

I shortened the list to only the parameters that meet this criteria.

-InputObject
    Specifies ServiceController objects that represent the services to stop. Enter a
    variable that contains the objects, or type a command or expression that gets the
    objects.
   
    Required?                    true
    Position?                    1
    Default value                none
    Accept pipeline input?       True (ByValue)
    Accept wildcard characters?  false
   

-Name
    Specifies the service names of the services to stop. Wildcard characters are permitted.
   
    Required?                    true
    Position?                    1
    Default value                none
    Accept pipeline input?       true(ByValue,ByPropertyName)
    Accept wildcard characters?  false

There are only two parameters where theAccept pipeline input attribute is True.  Now we need to look at the object types that each parameter will accept. Remember, we are passing a ServiceController object to this cmdlet.  The –Name parameter only accepts String objects so no go there. The –InputObject parameter does accept our ServiceController object.  That is why we are able to execute
PS C:\> Get-Service -Name "Bits" | Stop-Service





Comments

Popular posts from this blog

Adding a Comment to a GPO with PowerShell

As I'm writing this article, I'm also writing a customization for a PowerShell course I'm teaching next week in Phoenix.  This customization deals with Group Policy and PowerShell.  For those of you who attend my classes may already know this, but I sit their and try to ask the questions to myself that others may ask as I present the material.  I finished up my customization a few hours ago and then I realized that I did not add in how to put a comment on a GPO.  This is a feature that many Group Policy Administrators may not be aware of. This past summer I attended a presentation at TechEd on Group Policy.  One organization in the crowd had over 5,000 Group Policies.  In an environment like that, the comment section can be priceless.  I always like to write in the comment section why I created the policy so I know its purpose next week after I've completed 50 other tasks and can't remember what I did 5 minutes ago. In the Group Policy module for PowerShell V3, th

Return duplicate values from a collection with PowerShell

If you have a collection of objects and you want to remove any duplicate items, it is fairly simple. # Create a collection with duplicate values $Set1 = 1 , 1 , 2 , 2 , 3 , 4 , 5 , 6 , 7 , 1 , 2   # Remove the duplicate values. $Set1 | Select-Object -Unique 1 2 3 4 5 6 7 What if you want only the duplicate values and nothing else? # Create a collection with duplicate values $Set1 = 1 , 1 , 2 , 2 , 3 , 4 , 5 , 6 , 7 , 1 , 2   #Create a second collection with duplicate values removed. $Set2 = $Set1 | Select-Object -Unique   # Return only the duplicate values. ( Compare-Object -ReferenceObject $Set2 -DifferenceObject $Set1 ) . InputObject | Select-Object – Unique 1 2 This works with objects as well as numbers.  The first command creates a collection with 2 duplicates of both 1 and 2.   The second command creates another collection with the duplicates filtered out.  The Compare-Object cmdlet will first find items that are diffe

How to list all the AD LDS instances on a server

AD LDS allows you to provide directory services to applications that are free of the confines of Active Directory.  To list all the AD LDS instances on a server, follow this procedure: Log into the server in question Open a command prompt. Type dsdbutil and press Enter Type List Instances and press Enter . You will receive a list of the instance name, both the LDAP and SSL port numbers, the location of the database, and its status.