New-CMCloudDistributionPoint

Creates a cloud distribution point.

Syntax

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

Description

The New-CMCloudDistributionPoint cmdlet creates a cloud distribution point in Microsoft System Center Configuration Manager.

In System Center 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.

Examples

Example 1: Create a cloud distribution point

PS C:\> 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.

Required Parameters

-ManagementCertificatePath

Specifies a location for a management certificate.

Type:String
Aliases:ManagementCertificate
Required:True
Position:Named
Default value:None
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:Region
Parameter Sets:AnywhereAsia, AnywhereEurope, AnywhereUS, EastAsia, EastUS, NorthCentralUS, NorthEurope, SouthCentralUS, SoutheastAsia, WestEurope, WestUS
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ServiceCName

Specifies an alias, or CName, for a service.

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

Specifies a location for a service certificate.

Type:String
Aliases:ServiceCertificate
Required:True
Position:Named
Default value:None
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
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

Specifies a description for a cloud distribution point.

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

Indicates that wildcard handling is disabled.

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

Indicates that wildcard handling is enabled.

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

Specifies a password for a management certificate.

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

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

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

Specifies a password for a service certificate.

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

Specifies a Configuration Manager site code.

Type:String
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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