Get-CMCloudDistributionPoint

SYNOPSIS

Gets cloud-based distribution points.

SYNTAX

SearchByGroupName (Default)

Get-CMCloudDistributionPoint -DistributionPointGroupName <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

SearchByIdMandatory

Get-CMCloudDistributionPoint -Id <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

SearchByName

Get-CMCloudDistributionPoint [-Name <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

SearchByGroupId

Get-CMCloudDistributionPoint -DistributionPointGroupId <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

SearchByGroup

Get-CMCloudDistributionPoint -DistributionPointGroup <IResultObject> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

The Get-CMCloudDistributionPoint cmdlet gets one or more cloud-based distribution points in Microsoft System Center 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 on TechNet.

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.

EXAMPLES

Example 1: Get all cloud distribution points

PS C:\> Get-CMCloudDistributionPoint

This command gets all the cloud distribution points.

Example 2: Get a cloud distribution point by name

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

This command gets a distribution point named West01.

Example 3: Get a cloud distribution point by ID

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

This command gets a distribution point with the specified ID.

PARAMETERS

-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
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
Parameter Sets: SearchByGroup
Aliases: 

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

-DistributionPointGroupId

Specifies the ID of a distribution point group.

Type: String
Parameter Sets: SearchByGroupId
Aliases: 

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

-DistributionPointGroupName

Specifies the name of a distribution point group.

Type: String
Parameter Sets: SearchByGroupName
Aliases: 

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

-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
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
Parameter Sets: SearchByIdMandatory
Aliases: AzureServiceId

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

-Name

Specifies the name of a cloud distribution point.

Type: String
Parameter Sets: SearchByName
Aliases: 

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 (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

New-CMCloudDistributionPoint

Remove-CMCloudDistributionPoint

Set-CMCloudDistributionPoint

Start-CMCloudDistributionPoint

Stop-CMCloudDistributionPoint