| title | titleSuffix | description | ms.date | ms.topic | ms.author | author | manager | ROBOTS |
|---|---|---|---|---|---|---|---|---|
Version 1702 release notes |
Configuration Manager |
Release notes for the changes to PowerShell cmdlets in Configuration Manager version 1702. |
03/27/2017 |
conceptual |
banreetkaur |
Banreet |
apoorvseth |
NOINDEX |
Note
System Center Configuration Current Branch 1610 is the baseline for these changes. See Configuration Manager Cmdlet Library changes for Current Branch 1610 for more details.
For the latest cmdlet library documentation, see ConfigurationManager module reference.
The following cmdlets are no longer supported and have been removed:
-
Add-CMNokiaDeploymentType
-
Add-CMOutOfBandServicePoint
-
Add-CMSystemHealthValidatorPoint
-
Clear-CMAmtAuditLog
-
Disable-CMAmtAuditLog
-
Enable-CMAmtAuditLog
-
Enable-CMAutomaticAmtProvisioning
-
Get-CMAutomaticAmtProvisioningStatus
-
Get-CMCmdletUpdateCheck
-
Get-CMOutOfBandManagementComponent
-
Get-CMOutOfBandServicePoint
-
Get-CMSystemHealthValidatorPoint
-
Get-CMSystemHealthValidatorPointComponent
-
New-CMWiredProfileObject
-
New-CMWirelessProfileObject
-
Remove-CMAmtProvisioningData
-
Remove-CMNokiaDeploymentType
-
Remove-CMOutOfBandServicePoint
-
Remove-CMSystemHealthValidatorPoint
-
Send-CMCmdletUpdateCheck
-
Set-CMCmdletUpdateCheck
-
Set-CMNokiaDeploymentType
-
Set-CMOutOfBandManagementComponent
-
Set-CMOutOfBandServicePoint
-
Set-CMSystemHealthValidatorPointComponent
-
Update-CMAmtProvisioning
There is now support for importing the ConfigurationManager module by using a logical name or path.
If the C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin or equivalent path is added to the PSModulePath variable, the following can be used:
Import-Module ConfigrationManager
Otherwise, the following can be used:
Import-Module 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager'
These are known issues with the Cmdlet Library that are not resolved in this release.
64-bit PowerShell environment is required for these cmdlets.
- None
These are newly-added cmdlets for this release that add new functionality or enhance the functionality of existing cmdlets.
New cmdlets have been added for configuring iOS enrollment profiles.
-
Get-CMIosEnrollmentProfile
-
New-CMIosEnrollmentProfile
-
Remove-CMIosEnrollmentPRofile
-
Set-CMIosEnrollmentProfile
New cmdlets have been added for configuring cloud management gateway site roles.
-
Add-CMCloudManagementGatewayConnectionPoint
-
Get-CMCloudManagementGateway
-
Get-CMCloudManagementGatewayConnectionPoint
-
New-CMCloudManagementGateway
-
Remove-CMCloudManagementGateway
-
Remove-CMCloudManagementGatewayConnectionPoint
-
Set-CMCloudManagementGateway
-
Set-CMCloudManagementGatewayConnectionPoint
-
Start-CMCloudManagementGateway
-
Stop-CMCloudManagementGateway
New cmdlets have been added for configuring Data Warehouse Service point site roles.
-
Add-CMDataWarehouseServicePoint
-
Get-CMDataWarehouseServicePoint
-
Remove-CMDataWarehouseServicePoint
-
Set-CMDataWarehouseServicePoint
Several new cmdlets have been written and improvements made around deployment and deployment monitoring scenarios.
Get-CMDistributionStatus is a new cmdlet that can be used to get the distribution status of any content object such as applications, settings, or program packages.
Cmdlets have been created to get the object associated with an actual deployment.
-
Get-CMApplicationDeployment
-
Get-CMBaselineDeployment
-
Get-CMConfigurationPolicyDeployment
-
Get-CMPackageDeployment
-
Get-CMSoftwareUpdateDeployment
-
Get-CMTaskSequenceDeployment
Cmdlets have been created for creating new deployments. These cmdlets supersede pre-existing Start-CM*Deployment cmdlets.
-
New-CMApplicationDeployment
-
New-CMBaselineDeployment
-
New-CMConfigurationPolicyDeployment
-
New-CMPackageDeployment
-
New-CMSoftwareUpdateDeployment
-
New-TaskSequenceDeployment
Set-CM*Deployment, Remove-CM*Deployment, and Get-CM*DeploymentStatus now fully support the object pipeline.
The following Start-CM<feature>Deployment cmdlets have been deprecated. The replacement cmdlets may differ in parameter names but should have identical, and in some cases improved, functionality.
-
Start-CMApplicationDeployment (replaced by New-CMApplicationDeployment)
-
Start-CMPackageDeployment (replaced by New-CMPackageDeployment)
-
Start-CMBaselineDeployment (replaced by New-CMBaselineDeployment)
-
Start-CMConfigurationPolicyDeployment (replaced by New-CMConfigurationPolicyDeployment)
-
Start-CMTaskSequenceDeployment (replaced by New-CMTaskSequenceDeployment)
-
Start-CMSoftwareUpdateDeployment (replaced by New-CMSoftwareUpdateDeployment)
This cmdlet will retrieve the resultant client settings for a collection, device, or user.
New cmdlets have been added for creating and modifying operating system upgrade package update schedules.
-
Clear-CMOperatingSystemUpgradeUpdateSchedule
-
Get-CMOperatingSystemUpgradeUpdateSchedule
-
New-CMOperatingSystemUpgradeUpdateSchedule
-
Remove-CMOperatingSystemUpgradeUpdateSchedule
This cmdlet will remove a software update from a software update group.
The following changes have been made to existing cmdlets for this release. Changes may be new functionality, bug fixes, or deprecations, and may be breaking. If you use one of the cmdlets or feature areas listed in this section, please carefully review the changes to understand how they may affect your use.
Large SMS_EmbeddedPropertyList objects used by certain provider classes may not be properly consumed by the cmdlet framework, leading to undefined behavior when getting or setting these values.
Certain combinations of changes to antimalware policies or client settings can cause an invalid policy to be generated. When in this state, the SMS Provider will return an "Instance is not a valid client agent config" error.
Cmdlets for configuring management points and software update points have added the EnableCloudGateway parameter to enable these roles for use with the cloud management gateway.
CMMaintenanceWindow cmdlets now support configuring maintenance windows for sites. The output of Get-CMSite can be pipelined into New, Remove, or Set-CMMaintenanceWindow to configure the maintenance windows for a site.
Support for creating Nokia deployment types has been removed.
Cmdlet may fail unexpectedly with an ObjectNotFound error.
Cmdlet allows you to configure a distribution point as Internet-capable when HTTPS is not enabled.
Added AllowProxyTraffic parameter.
Previously unused InstallInternetServer parameter now changes distribution point configuration.
UseComputerAccount parameter has been deprecated. To use a computer account, set UserName to $null.
Enrollment point role missing configuration settings in created object.
Added ServiceHost parameter to allow specifying a remote enrollment point.
ContactEmail parameter cannot be set to null or empty value.
UserName does not validate for correct DOMAIN\user formatting.
StartUdpPort and EndUdpPort parameters do not validate values for certain incorrect configurations.
StartIPAddress and EndIPAddress parameters do not validate values for certain incorrect configurations.
UseAnyRangeIP parameter added.
ClientTransferRate parameter is no longer supported.
Cmdlet allows approving a previously processed affinity request.
InputObject parameter does not accept pipelined schedule object.
Cmdlet allows denying a previously processed affinity request.
Cannot retrieve client health or endpoint protection alerts.
ComputerName, Severity, and SiteCode parameters now accept array values.
Added MessageId, Module, Component, and FilterHashTable parameters for further filtering.
All string-based filter parameters now accept wildcards.
Cannot specify cmdlet without parameters.
Cmdlet will fail if importing a record that already exists and the new MergeIfExist parameter is not specified.
When ImportFolder is used, driver packages may use more space than expected.
Added support for pipelined objects from Get-CMDevice and Get-CMResource.
Cmdlet does not accept a pipelined object from Get-CMSiteSystemServer.
Cannot target a site system server for remote control if it is not also a client machine.
Added UserName parameter to allow for configuring the discovery account.
Added AddPublishingSite parameter.
Added UpdateSupersedence parameter.
FastLink is the only supported value for the hash table in the AddSiteSystemServer parameter. Support for all other values has been removed.
KeyStorageProvider parameter value may not apply as expected to the newly created certificate profile.
Support for creating Nokia global conditions has been removed.
Added AddSupportedOperatingSystemPlatform parameter.
MicrosoftAsVendor parameter value may not be applied to rule.
Added Vendor parameter to support third-party patches.
Added GenerateFailureAlert parameter.
Added RequirePostRebootFullScan parameter.
Added MediaStartDate and MediaExpirationDate parameters to support media expiration.
Added Application, DriverPackage, and Package parameters for adding additional media content.
Created query may not appear in the expected administrator console location.
EnrollmentProxyPoint parameter can be set to a null or empty value.
SiteCode parameter value may cause validation error to occur in administrator console.
Removal of a resource does not remove state migration associations.
AmbiguousParameterSet error may be raised when running the cmdlet.
Added UserName parameter to allow for configuring the discovery account.
Added AddPublishingSite and RemovePublishingSite parameters.
Increasing or decreasing priority may cause an ObjectNotFound error to be returned.
WhatIf may not display the expected policy name.
Real-time protection settings cannot be changed when using a pipelined object.
Cmdlet now accepts pipelined input from Get-CMAntimalwarePolicy.
Added AddSupportContact, AddOwner, RemoveSupportContact, RemoveOwner, ClearSupportContact, and ClearOwner parameters to support in-place modifications of support contacts or owners.
PassThru does not return the most up-to-date object.
PassThru does not return an SMS_ConfigurationItem object.
Added ClearRequiredConfigurationItem, ClearProhibitedConfigurationItem, ClearOptionalConfigurationItem, ClearOSConfigurationItem, ClearSoftwareUpdate, ClearBaseline, RemoveRequiredConfigurationItem, RemoveOptionalConfigurationItem, RemoveProhibitedConfigurationItem RemoveOSConfigurationItem, RemoveSoftwareUpdate, RemoveBaseline, AddSoftwareUpdate, and AddBaseline parameters.
FastLink is the only supported value for the hash table in the AddSiteSystemServer parameter. Support for all other values has been removed.
Using object pipeline may cause a ParameterBindingException error.
Added AddAccount and RemoveAccount parameters to support in-place modifications of client push accounts.
HealthAttestationUrl parameter value is not required if EnableHealthAttestation or UseOnPremisesHealthAttestation are set to true.
Added MigrationId parameter.
Support for modifying Nokia deployment types has been removed.
PollingSchedule value may not apply correctly to the discovery method.
Cmdlet allows you to configure a distribution point as Internet-capable when HTTPS is not enabled.
Added AllowProxyTraffic parameter.
Previously unused InstallInternetServer parameter now changes distribution point configuration.
UseComputerAccount parameter has been deprecated. To use a computer account, set UserName to $null.
Added UseSsl parameter.
FileReplicationAccountName parameter cannot be set to null or empty value.
Added ExclusionCollection, ExclusionCollectionId, ExclusionCollectionName, and EnableExclusionCollection parameters for configuring client upgrade exclusions.
ContactEmail parameter cannot be set to null or empty value.
MaximumUserDevice parameter now supports a value between 1 and 15.
Cmdlet may unexpectedly fail with an AetCleanupFailure error.
PassThru parameter does not cause an object to be returned.
UserName parameter does not validate value for correct DOMAIN\user formatting.
StartUdpPort and EndUdpPort parameters do not validate values for certain incorrect configurations.
StartIPAddress and EndIPAddress parameters do not validate values for certain incorrect configurations.
UseAnyRangeIP parameter added.
ClientTransferRate parameter is no longer supported.
Added AddSupportedOperatingSystemPlatform, RemoveSupportedOperatingSystemPlatform, and RunOnAnyPlatform parameters.
RemoveClientRequestServiceType may not properly remove the specified value.
Added SiteSystemCollectionBehavior, ThresholdOfSelectCollectionMax, ThresholdOfSelectCollectionByDefault, and ThresholdOfSelectCollectionMax parameters to configure device collection thresholds for a site.
PassThru parameter does not cause an object to be returned.
MicrosoftAsVendor parameter value may not be applied to rule.
Added Vendor parameter to support third-party patches.
Added GenerateFailureAlert parameter.
Added RequirePostRebootFullScan parameter.
EnableSynchronization and Schedule parameter usage may cause improper warning to be generated, or schedule to not be modified as expected.
Changes to Priority parameter value may not apply to the status filter rule.
UseDefaultText parameter has been deprecated. To use the default text, set CustomText to $null.
Authority parameter is not available in all parameter sets.