Get-DeliveryOptimizationStatus
Gets the current status of Delivery Optimization jobs and their peers.
Syntax
Default (Default)
Get-DeliveryOptimizationStatus
[-PeerInfo]
[-AsObject]
[-SelectPeerCount <Int32>]
[<CommonParameters>]
Description
The Get-DeliveryOptimizationStatus cmdlet returns a real-time snapshot of Delivery Optimization
jobs on the local device. Each job includes its file ID, size, download status, priority, transfer
totals, download sources, cache expiration, and pinning status.
Use PeerInfo to get per-file peer details, such as IP addresses, peer types, connection status, and bytes sent and received. Use AsObject with PeerInfo to group those details in an object for each file.
Examples
Example 1: Get current job status
Get-DeliveryOptimizationStatus
This command returns status objects for current Delivery Optimization jobs.
Example 2: Get peer details as objects
Get-DeliveryOptimizationStatus -PeerInfo -AsObject -SelectPeerCount 10
This command returns a file-level object for each job, with up to 10 peers in its PeersInfo property. Peers are sorted by bytes received, from highest to lowest.
Parameters
-AsObject
Returns a file-level object containing FileId and PeersInfo properties instead of writing file IDs and peer objects separately. Use this parameter with PeerInfo.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PeerInfo
Returns peer information for each file instead of the default job statistics. Peer information includes IP address, peer type, connection status, and transfer statistics.
Parameter properties
| Type: | SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SelectPeerCount
Specifies the maximum number of peers to return for each file when you use PeerInfo.
Peers are sorted by bytes received, from highest to lowest. Specify a positive integer.
The default is 5.
Parameter properties
| Type: | Int32 |
| Default value: | 5 |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
None
You can't pipe objects to this cmdlet.
Outputs
DOSwarmStats
Job statistics returned when you don't specify PeerInfo.
DOFilePeerInfo
A file ID and its associated peer objects, returned with PeerInfo and AsObject.
String
A file ID written before its peer details when you use PeerInfo without AsObject.
DOPeerInfo
Individual peer details returned with PeerInfo when you don't specify AsObject.
Notes
Use the FileId property when managing cached files with Set-DeliveryOptimizationStatus
or Delete-DeliveryOptimizationCache.