New-CMCloudDistributionPoint
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
Related Links
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for