Skip to content

Latest commit

 

History

History
241 lines (184 loc) · 6.46 KB

Start-DPGroupContentDistribution.md

File metadata and controls

241 lines (184 loc) · 6.46 KB
external help file Module Name online version schema
PSCMContentMgmt-help.xml
PSCMContentMgmt
2.0.0

Start-DPGroupContentDistribution

SYNOPSIS

Distributes objects to a given distribution point group.

SYNTAX

InputObject

Start-DPGroupContentDistribution -InputObject <PSObject> [-DistributionPointGroup <String>]
 [-SiteServer <String>] [-SiteCode <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

Properties

Start-DPGroupContentDistribution -ObjectID <String> -ObjectType <SMS_DPContentInfo>
 -DistributionPointGroup <String> [-SiteServer <String>] [-SiteCode <String>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Folder

Start-DPGroupContentDistribution -Folder <String> -DistributionPointGroup <String> [-SiteServer <String>]
 [-SiteCode <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Distributes objects to a given distribution point group.

Start-DPGroupContentDistribution 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.

EXAMPLES

EXAMPLE 1

Compare-DPGroupContent -Source "London DPs" -Target "Mancester DPs" | Start-DPGroupContentDistribution -DistributionPointGroup "Mancester DPs" -WhatIf

Compares the missing content objects in group Manchester DPs compared to London DPs, and distributes them to distribution point group Manchester DPs.

EXAMPLE 2

Start-DPGroupContentDistribution -Folder "E:\exported" -DistributionPointGroup "London DPs" -WhatIf

For all .pkgx files in folder "E:\exported" that use the following naming convention <ObjectType>_<ObjectID>.pkgx, distributes them to distribution point group London DPs.

EXAMPLE 3

Start-DPGroupContentDistribution -ObjectID ACC00007 -ObjectType Package -DistributionPointGroup "London DPs" -WhatIf

Nothing more than a wrapper for Start-CMContentDistribution. Distributes package ACC00007 to distribution point group London DPs.

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

-DistributionPointGroup

Name of distribution point group 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