Skip to content

Latest commit

 

History

History
244 lines (185 loc) · 6.72 KB

Start-DPContentDistribution.md

File metadata and controls

244 lines (185 loc) · 6.72 KB
external help file Module Name online version schema
PSCMContentMgmt-help.xml
PSCMContentMgmt
2.0.0

Start-DPContentDistribution

SYNOPSIS

Distributes objects to a given distribution point.

SYNTAX

InputObject

Start-DPContentDistribution -InputObject <PSObject> [-DistributionPoint <String>] [-SiteServer <String>]
 [-SiteCode <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Properties

Start-DPContentDistribution -ObjectID <String> -ObjectType <SMS_DPContentInfo> -DistributionPoint <String>
 [-SiteServer <String>] [-SiteCode <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Folder

Start-DPContentDistribution -Folder <String> -DistributionPoint <String> [-SiteServer <String>]
 [-SiteCode <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Distributes objects to a given distribution point.

Start-DPContentDistribution can accept input object from Get-DPContent or Get-DPDistributionStatus, by manually specifying -ObjectID and -ObjectType or by using -Folder where it will distribute all objects for .pkgx files found in said folder.

For more information on why you might use the -Folder parameter, please read the CONTENT LIBRARY MIRATION section in the About help topic about_PSCMContentMgmt_ExportImport.

EXAMPLES

EXAMPLE 1

Compare-DPContent -Source "dp1.contoso.com" -Target "dp2.contoso.com" | Start-DPContentDistribution -DistributionPoint "dp2.contoso.com" -WhatIf

Compares the missing content objects on dp2.contoso.com compared to dp1.contoso.com, and distributes them to dp2.contoso.com.

EXAMPLE 2

Start-DPContentDistribution -Folder "E:\exported" -DistributionPoint "dp2.contoso.com" -WhatIf

For all .pkgx files in folder E:\exported that use the following naming convention <ObjectType>_<ObjectID>.pkgx, distributes them to dp2.contoso.com.

For more information on why you might use the -Folder parameter, please read the CONTENT LIBRARY MIRATION section in the About help topic about_PSCMContentMgmt_ExportImport.

EXAMPLE 3

Start-DPContentDistribution -ObjectID ACC00007 -ObjectType Package -DistributionPoint "dp2.contoso.com" -WhatIf

Nothing more than a wrapper for Start-CMContentDistribution. Distributes package ACC00007 to dp2.contoso.com.

PARAMETERS

-InputObject

A PSObject type "PSCMContentMgmt" generated by Get-DPContent

Type: PSObject
Parameter Sets: InputObject
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ObjectID

Unique ID of the content object you want to distribute.

For Applications the ID must be the CI_ID value whereas for all other content objects the ID is PackageID.

When using this parameter you must also use ObjectType.

Type: String
Parameter Sets: Properties
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ObjectType

Object type of the content object you want to distribute.

Can be one of the following values: "Package", "DriverPackage", "DeploymentPackage", "OperatingSystemImage", "OperatingSystemInstaller", "BootImage", "Application".

When using this parameter you must also use ObjectID.

Type: SMS_DPContentInfo
Parameter Sets: Properties
Aliases:
Accepted values: Package, DriverPackage, TaskSequence, DeploymentPackage, OperatingSystemImage, BootImage, OperatingSystemInstaller, Application

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Folder

For all .pkgx files in this folder that use the following naming convention "<ObjectType>_<ObjectID>.pkgx", distribute the <ObjectID> of type <ObjectType> to -DistributionPoint.

This can be useful if you have a folder filled with .pkgx files, generated by Export-DPContent, and want to distribute those objects to a distribution point.

Type: String
Parameter Sets: Folder
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistributionPoint

Name of distribution point (as it appears in Configuration Manager, usually FQDN) you want to distribute objects to.

Type: String
Parameter Sets: InputObject
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: String
Parameter Sets: Properties, Folder
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SiteServer

FQDN address of the site server (SMS Provider).

You only need to use this parameter once for any function of PSCMContentMgmt that also has a -SiteServer parameter. PSCMContentMgmt remembers the site server for subsequent commands, unless you specify the parameter again to change site server.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SiteCode

Site code of which the server specified by -SiteServer belongs to.

You only need to use this parameter once for any function of PSCMContentMgmt that also has a -SiteCode parameter. PSCMContentMgmt remembers the site code for subsequent commands, unless you specify the parameter again to change site code.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

System.Management.Automation.PSObject

OUTPUTS

System.Management.Automation.PSObject

NOTES

RELATED LINKS