Edit

Share via


Get-CMDistributionPoint

Gets a distribution point.

Syntax

SearchByName (Default)

Get-CMDistributionPoint
    [[-SiteSystemServerName] <String>]
    [-AllSite]
    [-SiteCode <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByGroup

Get-CMDistributionPoint
    -DistributionPointGroup <IResultObject>
    [-AllSite]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByGroupId

Get-CMDistributionPoint
    -DistributionPointGroupId <String>
    [-AllSite]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByGroupName

Get-CMDistributionPoint
    -DistributionPointGroupName <String>
    [-AllSite]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

SearchByValue

Get-CMDistributionPoint
    -InputObject <IResultObject>
    [-AllSite]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [<CommonParameters>]

Description

The Get-CMDistributionPoint cmdlet gets a distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get a distribution point

PS XYZ:\> Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.contoso.com"

This command gets the distribution point for the site system server named MySiteSys_11310.contoso.com.

Example 2: Get a distribution point by using the pipeline

PS XYZ:\> Get-CMDistributionPointGroup -Name "DPGroup" | Get-CMDistributionPoint

This command gets the distribution point group object named DPGroup and uses the pipeline operator to pass the object to Get-CMDistributionPoint, which gets all of the distribution points for the distribution point group object.

Parameters

-AllSite

The Get-CMDistributionPoint cmdlet gets a distribution point.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:AllSites

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
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

-DistributionPointGroup

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

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByGroup
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-DistributionPointGroupId

Specifies the ID of a distribution point group.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByGroupId
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DistributionPointGroupName

Specifies the name of a distribution point group.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByGroupName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Parameter properties

Type:SwitchParameter
Default value:None
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

-InputObject

Specifies a site system server object. To obtain a site system server object, use the Get-CMSiteSystemServer cmdlet.

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByValue
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteCode

Specifies the site code of the site that is associated with a distribution point.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SiteSystemServerName

Specifies a fully qualified ___domain name (FQDN) of the server that hosts the site system role.

Parameter properties

Type:String
Default value:None
Supports wildcards:True
DontShow:False
Aliases:Name, ServerName

Parameter sets

SearchByName
Position:0
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject

IResultObject