Add-CMDistributionPointToGroup

Add-CMDistributionPointToGroup

Adds a distribution point to a distribution point group.

Syntax

Parameter Set: AddDistributionPointToGroupById_Id
Add-CMDistributionPointToGroup -DistributionPointGroupId <String> -DistributionPointId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupById_Name
Add-CMDistributionPointToGroup -DistributionPointGroupName <String> -DistributionPointId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupById_Object
Add-CMDistributionPointToGroup -DistributionPointGroup <IResultObject> -DistributionPointId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupByName_Id
Add-CMDistributionPointToGroup -DistributionPointGroupId <String> -DistributionPointName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupByName_Name
Add-CMDistributionPointToGroup -DistributionPointGroupName <String> -DistributionPointName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupByName_Object
Add-CMDistributionPointToGroup -DistributionPointGroup <IResultObject> -DistributionPointName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupByObject_Id
Add-CMDistributionPointToGroup -DistributionPoint <IResultObject> -DistributionPointGroupId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupByObject_Name
Add-CMDistributionPointToGroup -DistributionPoint <IResultObject> -DistributionPointGroupName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: AddDistributionPointToGroupByObject_Object
Add-CMDistributionPointToGroup -DistributionPoint <IResultObject> -DistributionPointGroup <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Add-CMDistributionPointToGroup cmdlet adds a distribution point to a distribution point group. Distribution point groups provide a logical grouping of distribution points for content distribution.

You can add one or more distribution points from any site in the Microsoft System Center 2012 Configuration Manager hierarchy to the distribution point group. You can also add the distribution point to more than one distribution point group so that you can manage and monitor content from a central location for distribution points that span multiple sites.

Parameters

-DistributionPoint<IResultObject>

Specifies a distribution point object. To obtain a CMDistributionPoint object, use the Get-CMDistributionPoint cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DistributionPointGroup<IResultObject>

Specifies a distribution point group object. To obtain a CMDistributionPointGroup object, use the Get-CMDistributionPointGroup cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DistributionPointGroupId<String>

Specifies the ID of a distribution point group.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DistributionPointGroupName<String>

Specifies the name of a distribution point group.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DistributionPointId<String>

Specifies the ID of a distribution point.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DistributionPointName<String>

Specifies the name of a distribution point.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Add a distribution point to a group to a group

This command adds the distribution point that has the Id FA921CF2-89C9-407D-A21D-FE6947F2C00A to the distribution point group named DPG01.

PS C:\> Add-CMDistributionPointToGroup -DistributionPointGroupName "DPG01" -Id "{FA921CF2-89C9-407D-A21D-FE6947F2C00A}"

Get-CMDistributionPointGroup

Get-CMDistributionPoint