Remove-CMCloudDistributionPoint

Remove-CMCloudDistributionPoint

Removes cloud-based distribution points.

Syntax

Parameter Set: SearchByIdMandatory
Remove-CMCloudDistributionPoint -Id <String[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByNameMandatory
Remove-CMCloudDistributionPoint -Name <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Remove-CMCloudDistributionPoint -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Remove-CMCloudDistributionPoint cmdlet removes specified cloud-based distribution points.

When you remove a distribution point, System Center 2012 Configuration Manager deletes all the content stored there. If you want to suspend a distribution point temporarily, use the Stop-CMCloudDistributionPoint cmdlet.

Parameters

-Force

Forces the command to run without asking for user confirmation.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Id<String[]>

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

Aliases

AzureServiceId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

Specifies a cloud distribution point object. To obtain a cloud distribution point object, you can use the Get-CMCloudDistributionPoint cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a cloud 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: Remove all distribution points

This command removes all the cloud distribution points from System Center 2012 Configuration Manager. Unless you use the Force parameter, the cmdlet prompts you for confirmation.

PS C:\> Remove-CMCloudDistributionPoint 

Example 2: Remove a distribution point using a name

This command removes the cloud distribution point named West01. Unless you use the Force parameter, the cmdlet prompts you for confirmation.

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

Example 3: Remove a distribution point using an ID

This command removes the cloud distribution point that has the specified identifier. Unless you use the Force parameter, the cmdlet prompts you for confirmation.

PS C:\> Remove-CMCloudDistributionPoint -Id "16777236"

Get-CMCloudDistributionPoint

New-CMCloudDistributionPoint

Set-CMCloudDistributionPoint

Start-CMCloudDistributionPoint

Stop-CMCloudDistributionPoint