Edit

Share via

New-CMCloudDistributionPoint

  • Reference
Module:
ConfigurationManager

Creates a cloud distribution point.

Syntax

New-CMCloudDistributionPoint
   [-Description <String>]
   [-EnvironmentSetting <AzureEnvironment>]
   [-ManagementCertificatePassword <SecureString>]
   -ManagementCertificatePath <String>
   [-PassThru]
   -Region <AzureRegion>
   [-ServiceCertificatePassword <SecureString>]
   -ServiceCertificatePath <String>
   -ServiceCName <String>
   [-SiteCode <String>]
   [-StorageCriticalThreshold <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningThreshold <Int32>]
   -SubscriptionId <String>
   [-TrafficCriticalThreshold <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficWarningThreshold <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-CMCloudDistributionPoint cmdlet creates a cloud distribution point 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.

Note

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

Examples

Example 1: Create a cloud distribution point

PS XYZ:\> New-CMCloudDistributionPoint -ManagementCertificatePath "C:\Certificates\Management.pfx" -Region "WestUS" -ServiceCertificatePath "C:\Certificates\Distribution.pfx" -ServiceCName "distribution-server.contoso.com" -SiteCode "ContosoSite"-SubscriptionID "81c87063-04a3-4abf-8e4c-736569bc1f60"

This command creates a distribution with the canonical name server.contoso.com. The distribution point is located in the WestUS Azure region and is associated with the Azure subscription 81c87063-04a3-4abf-8e4c-736569bc1f60.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-Description

Specifies a description for a cloud distribution point.

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

-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

-EnvironmentSetting

{{ Fill EnvironmentSetting Description }}

Type:AzureEnvironment
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
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

-ManagementCertificatePassword

Specifies a password for a management certificate.

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

-ManagementCertificatePath

Specifies a location for a management certificate.

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

-PassThru

Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.

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

-Region

Specifies a region. This is the Azure region where you want to create the cloud service that hosts this distribution point. The acceptable values for this parameter are:

  • AnywhereAsia
  • AnywhereEurope
  • AnywhereUS
  • EastAsia
  • EastUS
  • NorthCentralUS
  • NorthEurope
  • SouthCentralUS
  • SoutheastAsia
  • WestEurope
  • WestUS
Type:AzureRegion
Accepted values:AnywhereAsia, AnywhereEurope, AnywhereUS, EastAsia, EastUS, NorthCentralUS, NorthEurope, SouthCentralUS, SoutheastAsia, WestEurope, WestUS, WestUS2, WestCentralUS, USGovernmentIowa, USGovernmentVirginia, USGovernmentArizona, USGovernmentTexas, USDoDCentral, USDoDEast, AustraliaEast, AustraliaSoutheast, BrazilSouth, CanadaCentral, CanadaEast, CentralIndia, CentralUS, EastUS2, JapanEast, JapanWest, SouthIndia, UKSouth, UKWest, WestIndia, FranceSouth, FranceCentral, KoreaSouth, KoreaCentral, AustraliaCentral, AustraliaCentral2, ChinaEast, ChinaNorth, GermanyCentral, GermanyNortheast, SouthAfricaNorth, SouthAfricaWest
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ServiceCertificatePassword

Specifies a password for a service certificate.

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

-ServiceCertificatePath

Specifies a location for a service certificate.

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

-ServiceCName

Specifies an alias, or CName, for a service.

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

-SiteCode

Specifies a Configuration Manager site code.

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

-StorageCriticalThreshold

Specifies the percentage for a critical alert to occur, based on the storage alert threshold.

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

-StorageQuotaGB

Specifies the threshold value, in gigabytes, that triggers errors or warnings for total content storage.

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

-StorageWarningThreshold

Specifies the percentage for a warning alert to occur, based on the storage alert threshold.

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

-SubscriptionId

Specifies a subscription ID for your Azure account. To get a subscription ID, use the Azure Management Portal.

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

-TrafficCriticalThreshold

Specifies the percentage for a critical alert to occur, based on the traffic out alert threshold.

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

-TrafficOutGB

Specifies the threshold value, in gigabytes, that triggers errors or warnings, for monthly traffic out of Azure Storage Service.

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

-TrafficWarningThreshold

Specifies the percentage for a warning alert to occur, based on the traffic out alert threshold.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

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

Inputs

None

Outputs

IResultObject

IResultObject[]

IResultObject[]

IResultObject