Edit

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.