Edit

Share via

Get-CMCloudDistributionPoint

  • Reference
Module:
ConfigurationManager

Gets cloud-based distribution points.

Syntax

Get-CMCloudDistributionPoint
   -DistributionPointGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCloudDistributionPoint
   -DistributionPointGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCloudDistributionPoint
   -DistributionPointGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCloudDistributionPoint
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCloudDistributionPoint
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

The Get-CMCloudDistributionPoint cmdlet gets one or more cloud-based distribution points in Configuration Manager.

In Configuration Manager, you can use a cloud service in Azure to host a distribution point for storing files to download to clients. You can send packages and apps to and host packages and apps in cloud distribution points. For more information about cloud distribution points, see Planning for Content Management in Configuration Manager.

You can use the Get-CMCloudDistributionPoint cmdlet to get distribution points to use with other cmdlets. For example, you might want to get a distribution point and then use the Stop-CMCloudDistributionPoint cmdlet to suspend it.

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 all cloud distribution points

PS XYZ:\> Get-CMCloudDistributionPoint

This command gets all the cloud distribution points.

Example 2: Get a cloud distribution point by name

PS XYZ:\> Get-CMCloudDistributionPoint -Name "West01"

This command gets a distribution point named West01.

Example 3: Get a cloud distribution point by ID

PS XYZ:\> Get-CMCloudDistributionPoint -Id "16777230"

This command gets a distribution point with the specified ID.

Parameters

-DisableWildcardHandling

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

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

-DistributionPointGroup

Specifies a CMDistributionPointGroup object. To get a CMDistributionPointGroup object, use the Get-CMDistributionPointGroup cmdlet.

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

-DistributionPointGroupId

Specifies the ID of a distribution point group.

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

-DistributionPointGroupName

Specifies the name of a distribution point group.

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

-ForceWildcardHandling

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

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

-Id

Specifies an array of identifiers for cloud distribution points. You can use a comma separated list.

Type:String
Aliases:AzureServiceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a cloud distribution point.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject[]

IResultObject

IResultObject[]

IResultObject