Cmdlet Piping
Piping enables you to chain cmdlets together. The object returned by one cmdlet is used as input by another cmdlet. The combination of cmdlets is implemented in a single command, with two consecutive cmdlets linked by the pipe character. The object returned by the cmdlet to the left of the pipe character is input to the cmdlet to the right of the character. Likewise, that cmdlet can be combined with another cmdlet by a pipe character, with the object output by the second cmdlet used as input to the third cmdlet. The commands in such a pipeline are processed from left to right in the order that they appear; however, processing is handled as a single operation and output is displayed as it is generated.
Piping Combinations
Microsoft AppFabric 1.1 for Windows Server cmdlets are designed to be used in combination with other cmdlets. Not all cmdlets can be used in a piping sequence. The output of the cmdlet to the left of the pipe character must match the input of the cmdlet to the right of the pipe character. There are two ways in which this can occur. First, the first cmdlet can output an object that has the same type as the input object required by the second cmdlet. Second, an attribute of the output object from the first cmdlet can be accepted as a parameter of the second cmdlet. The first condition is the default, and the Windows PowerShell engine checks for it when the command is executed. If the first condition does not occur, the Windows PowerShell engine will look for the second condition.
The following AppFabric parameters can be linked in a piping sequence:
| Cmdlet Producer | Output Data Type | Cmdlet Consumer |
|---|---|---|
Get-ASApplication |
ApplicationInfo |
Common with ServiceInfo: Get-ASInstanceUnloadPolicy Set-ASInstanceUnloadPolicy Get-ASAppServicePersistence Set-ASAppServicePersistence Get-ASInstanceExceptionPolicy Get-ASAppServiceTracking Profile Get-ASAppServiceTracking Import-ASAppServiceTrackingProfile Remove-ASAppServiceTracking Profile Get-ASAppServiceCertificate Set-ASAppServiceCertificate Get-ASAppServiceThrottling Set-ASAppServiceThrottling Only ApplicationInfo: Enable-ASAppDebugTracing Disable-ASAppDebugTracing Get-ASAppDebugTracing Set-ASAppDebugTracing Get-ASApplication Enable-ASAppMessageLogging Disable-ASAppMessageLogging Get-ASAppMessageLogging Set-ASAppMessageLogging Get-ASAppPerformanceCounter Set-ASAppPerformanceCounter Get-ASAppService |
Get-ASAppService |
ServiceInfo |
Common with Application Info: Get-ASInstanceUnloadPolicy Set-ASInstanceUnloadPolicy Get-ASAppServicePersistence Set-ASAppServicePersistence Get-ASInstanceExceptionPolicy Get-ASAppServiceTrackingProfile Import-ASAppServiceTrackingProfile Remove-ASAppServiceTrackingProfile Get-ASAppServiceCertificate Set-ASAppServiceCertificate Get-ASAppServiceThrottling Set-ASAppServiceThrottling Only ServiceInfo: Enable-ASAppServiceAutoStart Disable-ASAppServiceAutoStart Get-ASAppServiceAutoStart Get-ASAppServiceTracking Get-ASAppServiceEndpoint Set-ASAppServiceEndpoint Get-ASAppServiceEndpointAuthentication Get-ASAppServiceEndpointTransportQuota Set-ASAppServiceEndpointTransportQuota Get-ASAppServiceInstance |
Get-ASAppDebugTracing |
DebugTracingInfo |
- |
Get-ASInstanceExceptionPolicy |
InstanceSuspendOn UnhandledExceptionInfo |
- |
Get-ASInstanceUnloadPolicy |
InstanceUnloadInfo |
- |
Get-ASAppMessageLogging |
ApplicationMessageLoggingInfo |
- |
Get-ASAppMonitoring |
- |
|
Get-ASMonitoringDatabaseArchiveConfiguration |
DatabaseInfo |
- |
Get-ASAppPerformanceCounter |
PerformanceCounterInfo |
- |
Get-ASAppServiceAutoStart |
ServiceAutoStartInfo |
- |
Get-ASAppServiceCertificate |
ServiceCertificateInfo |
- |
Get-ASAppServiceEndpoint |
ServiceEndpointInfo |
Get-ASAppServiceEndpointAuthentication Get-ASAppServiceEndpointTransportQuota Set-ASAppServiceEndpointAuthentication Set-ASAppServiceEndpointTransportQuota |
Get-ASAppServiceCertificateEndpointAuthentication |
ServiceEndpointAuthenticationInfo |
- |
Get-ASAppServiceCertificateEndpointTransportQuota |
ServiceEndpointTransportQuotaInfo |
- |
Get-ASAppServiceInstance |
ServiceInstanceInfo |
Stop-ASAppServiceInstance Suspend-ASAppServiceInstance Resume-ASAppServiceInstance |
Get-ASAppServicePersistence |
ServicePersistenceInfo |
- |
Get-ASAppServiceThrottling |
ServiceThrottlingInfo |
- |
Get-ASAppServiceTrackingProfile |
TrackingProfileInfo |
- |
2012-09-12