|
| 1 | +--- |
| 2 | +author: Banreet |
| 3 | +ms.author: banreetkaur |
| 4 | +ms.prod: configuration-manager |
| 5 | +ms.technology: configmgr-core |
| 6 | +ms.topic: include |
| 7 | +ms.date: 07/04/2022 |
| 8 | +ms.localizationpriority: medium |
| 9 | +--- |
| 10 | + |
| 11 | +## <a name="bkmk_powershell"></a> PowerShell release notes preview |
| 12 | + |
| 13 | +<!--14637353--> |
| 14 | + |
| 15 | +These release notes summarize changes to the Configuration Manager PowerShell cmdlets in this technical preview release. |
| 16 | + |
| 17 | +For more information about PowerShell for Configuration Manager, see [Get started with Configuration Manager cmdlets](/powershell/sccm/overview). |
| 18 | + |
| 19 | +### New cmdlets |
| 20 | + |
| 21 | +#### Approve-CMOrchestrationGroupScript |
| 22 | + |
| 23 | +Use this cmdlet to approve an orchestration group script. For more information, see [About orchestration groups in Configuration Manager](../../../../../sum/deploy-use/orchestration-groups.md). |
| 24 | + |
| 25 | +```powershell |
| 26 | +$referenceOG = Get-CMOrchestrationGroup -Name $Script:OGName |
| 27 | +$preScript = $referenceOG | Get-CMOrchestrationGroupScript -ScriptType Pre |
| 28 | +$preScript | Approve-CMOrchestrationGroupScript -Comment "Approve" |
| 29 | +Approve-CMOrchestrationGroupScript -ScriptGuid $PreScript.ScriptGuid |
| 30 | +``` |
| 31 | + |
| 32 | +#### Deny-CMOrchestrationGroupScript |
| 33 | + |
| 34 | +Use this cmdlet to deny an orchestration group script. For more information, see [About orchestration groups in Configuration Manager](../../../../../sum/deploy-use/orchestration-groups.md). |
| 35 | + |
| 36 | +```powershell |
| 37 | +$referenceOG = Get-CMOrchestrationGroup -Name $Script:OGName |
| 38 | +$preScript = $referenceOG | Get-CMOrchestrationGroupScript -ScriptType Pre |
| 39 | +$preScript | Deny-CMOrchestrationGroupScript -Comment "Deny" |
| 40 | +Deny-CMOrchestrationGroupScript -ScriptGuid $PreScript.ScriptGuid -Comment "Deny" |
| 41 | +``` |
| 42 | + |
| 43 | +#### Get-CMOrchestrationGroupScript |
| 44 | + |
| 45 | +Use this cmdlet to get a script from the specified orchestration group. For more information, see [About orchestration groups in Configuration Manager](../../../../../sum/deploy-use/orchestration-groups.md). |
| 46 | + |
| 47 | +```powershell |
| 48 | +$referenceOG = Get-CMOrchestrationGroup -Name $Script:OGName |
| 49 | +$preScript = $referenceOG | Get-CMOrchestrationGroupScript -ScriptType Pre |
| 50 | +``` |
| 51 | + |
| 52 | +#### Start-CMDPMigration |
| 53 | + |
| 54 | +Use this cmdlet to start migration from source distribution point to destination distribution point. For more information, see [About migration in Configuration Manager](../../../../../core/migration/planning-a-migration-job-strategy.md). |
| 55 | + |
| 56 | +```powershell |
| 57 | +Start-CMDPMigration -SourceDistributionPointName sourceServer.dp -DestinationDistributionPointName destinationServer.dp -LockSourceDP 1 |
| 58 | +``` |
| 59 | + |
| 60 | +#### Stop-CMDPMigration |
| 61 | + |
| 62 | +Use this cmdlet to stop migration from source distribution point to destination distribution point. For more information, see [About migration in Configuration Manager](../../../../../core/migration/planning-a-migration-job-strategy.md). |
| 63 | + |
| 64 | +```powershell |
| 65 | +Stop-CMDPMigration -SourceDistributionPointName sourceServer.dp -DestinationDistributionPointName destinationServer.dp -LockSourceDP 1 |
| 66 | +``` |
| 67 | + |
| 68 | +#### Get-CMDPMigrationContentStatus |
| 69 | + |
| 70 | +Use this cmdlet to get the content status of the migration from source distribution point to destination distribution point. For more information, see [About migration in Configuration Manager](../../../../../core/migration/planning-a-migration-job-strategy.md). |
| 71 | + |
| 72 | +```powershell |
| 73 | +Get-CMDPMigrationContentStatus -SourceDistributionPointName sourceServer.dp -DestinationDistributionPointName destinationServer.dp |
| 74 | +``` |
| 75 | + |
| 76 | +#### Get-CMDPMigrationStatus |
| 77 | + |
| 78 | +Use this cmdlet to get the status of the migration from source distribution point to destination distribution point. For more information, see [About migration in Configuration Manager](../../../../../core/migration/planning-a-migration-job-strategy.md). |
| 79 | + |
| 80 | +```powershell |
| 81 | +Get-CMDPMigrationStatus -SourceDistributionPointName sourceServer.dp -DestinationDistributionPointName destinationServer.dp |
| 82 | +``` |
| 83 | + |
| 84 | +#### Get-CMTrustedRootCertificationAuthority |
| 85 | + |
| 86 | +Use this cmdlet to get the certificates for trusted root certification authorities from the site. |
| 87 | + |
| 88 | +```powershell |
| 89 | +$ci =Get-CMTrustedRootCertificationAuthority |
| 90 | +$ci =Get-CMTrustedRootCertificationAuthority -ViewDetail |
| 91 | +``` |
| 92 | + |
| 93 | +#### New-CMAADClientApplication |
| 94 | + |
| 95 | +Use this cmdlet to create a client app registration in Azure Active Directory (Azure AD). When you run this cmdlet, it will prompt you to sign in to your tenant. For more information on this app registration, see [Manually register Azure AD apps for the CMG](../../../../clients/manage/cmg/manually-register-azure-ad-apps.md). |
| 96 | + |
| 97 | +```powershell |
| 98 | +$serverApp = New-CMAADServerApplication -AppName $appName |
| 99 | +New-CMAADClientApplication -AppName $name -InputObject $serverApp |
| 100 | +``` |
| 101 | + |
| 102 | +#### New-CMAADServerApplication |
| 103 | + |
| 104 | +Use this cmdlet to create a server app registration in Azure AD. When you run this cmdlet, it will prompt you to sign in to your tenant. For more information on this app registration, see [Manually register Azure AD apps for the CMG](../../../../clients/manage/cmg/manually-register-azure-ad-apps.md). |
| 105 | + |
| 106 | +```powershell |
| 107 | +New-CMAADServerApplication -AppName $appName |
| 108 | +``` |
| 109 | + |
| 110 | +#### Set-CMDefaultBoundaryGroup |
| 111 | + |
| 112 | +Use this cmdlet to modify the properties of a default site boundary group. You can set the options to include and prefer the cloud-based sources for the clients in default site boundary group. For more information on boundary groups, see [About boundary groups in Configuration Manager](../../../../../core/servers/deploy/configure/boundary-groups.md). |
| 113 | + |
| 114 | +```powershell |
| 115 | +Set-CMDefaultBoundaryGroup -IncludeCloudBasedSources $true -PreferCloudBasedSources $true |
| 116 | +``` |
| 117 | + |
| 118 | +### Modified cmdlets |
| 119 | + |
| 120 | +#### Add-CMComplianceSettingWqlQuery |
| 121 | + |
| 122 | +For more information, see [Add-CMComplianceSettingWqlQuery](/powershell/module/configurationmanager/Add-CMComplianceSettingWqlQuery). |
| 123 | + |
| 124 | +**Non-breaking changes** |
| 125 | + |
| 126 | +When using this cmdlet, you can now specify $null value to the parameter **WhereClause**. |
| 127 | + |
| 128 | +#### Add-CMManagementPoint |
| 129 | + |
| 130 | +For more information, see [Add-CMManagementPoint](/powershell/module/configurationmanager/Add-CMManagementPoint). |
| 131 | + |
| 132 | +**Non-breaking changes** |
| 133 | + |
| 134 | +When you enable cloud gateway, **ClientConnectionTypes.InternetAndIntranet** is now the default value. |
| 135 | + |
| 136 | +#### Add-CMReportingServicePoint |
| 137 | + |
| 138 | +For more information, see [Add-CMReportingServicePoint](/powershell/module/configurationmanager/Add-CMReportingServicePoint). |
| 139 | + |
| 140 | +**Non-breaking changes** |
| 141 | + |
| 142 | +This cmdlet will be blocked to run on PowerShell7, as SOAP is not supported in PowerShell7. This cmdlet requires the .NET Framework instead of .NET Core that's used with PowerShell version 7. |
| 143 | + |
| 144 | +#### Get-CMNotification |
| 145 | + |
| 146 | +For more information, see [Get-CMNotification](/powershell/module/configurationmanager/Get-CMNotification). |
| 147 | + |
| 148 | +**Non-breaking changes** |
| 149 | + |
| 150 | +You can now use this cmdlet to get built-in notification by using parameter **IsBuiltIn**. |
| 151 | +You can now also use this cmdlet to get notification that could be dismissed by using parameter **CanDismiss**. |
| 152 | + |
| 153 | +#### Get-CMObjectSecurityScope |
| 154 | + |
| 155 | +For more information, see [Get-CMObjectSecurityScope](/powershell/module/configurationmanager/Get-CMObjectSecurityScope). |
| 156 | + |
| 157 | +**Non-breaking changes** |
| 158 | + |
| 159 | +You can now use this cmdlet to get the security scope of a specified folder object. |
| 160 | + |
| 161 | +#### New-CMCloudManagementGateway |
| 162 | + |
| 163 | +For more information, see [New-CMCloudManagementGateway](/powershell/module/configurationmanager/New-CMCloudManagementGateway). |
| 164 | + |
| 165 | +**Non-breaking changes** |
| 166 | + |
| 167 | +Added parameters **VMSSVMSize** and **Version** to support creating a cloud management gateway (CMG) using a virtual machine scale set. |
| 168 | + |
| 169 | +#### New-CMCoManagementPolicy |
| 170 | + |
| 171 | +For more information, see [New-CMCoManagementPolicy](/powershell/module/configurationmanager/New-CMCoManagementPolicy). |
| 172 | + |
| 173 | +**Non-breaking changes** |
| 174 | + |
| 175 | +You can now view the policy created as well as prevent creation of second policy from this cmdlet. |
| 176 | +You can now also create child policies for each workload, like UI, while creating Co-Management policy from this cmdlet. |
| 177 | + |
| 178 | +#### New-CMComplianceRuleRegistryKeyPermission |
| 179 | + |
| 180 | +For more information, see [New-CMComplianceRuleRegistryKeyPermission](/powershell/module/configurationmanager/New-CMComplianceRuleRegistryKeyPermission). |
| 181 | + |
| 182 | +**Non-breaking changes** |
| 183 | + |
| 184 | +Fixed an issue in **OperandDataType** property when creating a rule. |
| 185 | + |
| 186 | +#### New-CMFolder |
| 187 | + |
| 188 | +For more information, see [New-CMFolder](/powershell/module/configurationmanager/New-CMFolder). |
| 189 | + |
| 190 | +**Non-breaking changes** |
| 191 | + |
| 192 | +An issue in folder path validation has been fixed when using this cmdlet to create a new folder in the console. |
| 193 | + |
| 194 | +#### Set-CMClientSettingClientCache |
| 195 | + |
| 196 | +For more information, see [Set-CMClientSettingClientCache](/powershell/module/configurationmanager/Set-CMClientSettingClientCache). |
| 197 | + |
| 198 | +**Non-breaking changes** |
| 199 | + |
| 200 | +Added a new parameter **MinCacheTombstoneContentMins** to support setting the minimum duration before the client can remove cached content. |
| 201 | + |
| 202 | +#### Set-CMClientSettingComplianceSetting |
| 203 | + |
| 204 | +For more information, see [Set-CMClientSettingComplianceSetting](/powershell/module/configurationmanager/Set-CMClientSettingComplianceSetting). |
| 205 | + |
| 206 | +**Non-breaking changes** |
| 207 | + |
| 208 | +Added a new parameter **ScriptExecutionTimeoutSecs** to extend the script execution timeout value. |
| 209 | + |
| 210 | +#### Set-CMClientSettingEndpointProtection |
| 211 | + |
| 212 | +For more information, see [Set-CMClientSettingEndpointProtection](/powershell/module/configurationmanager/Set-CMClientSettingEndpointProtection). |
| 213 | + |
| 214 | +**Non-breaking changes** |
| 215 | + |
| 216 | +You can now specify the defender agent type with the new parameter **DefenderAgent**. |
| 217 | + |
| 218 | +#### Set-CMComplianceSettingWqlQuery |
| 219 | + |
| 220 | +For more information, see [Set-CMComplianceSettingWqlQuery](/powershell/module/configurationmanager/Set-CMComplianceSettingWqlQuery). |
| 221 | + |
| 222 | +**Non-breaking changes** |
| 223 | + |
| 224 | +When using this cmdlet, you can now specify $null value to the parameter **WhereClause**. |
| 225 | + |
| 226 | +#### Set-CMClientSettingComputerRestart |
| 227 | + |
| 228 | +For more information, see [Set-CMClientSettingComputerRestart](/powershell/module/configurationmanager/Set-CMClientSettingComputerRestart). |
| 229 | + |
| 230 | +**Non-breaking changes** |
| 231 | + |
| 232 | +- Extended the validation range of the parameters **CountdownMins** and **RebootLogoffNotificationCountdownMins** to align with the console. |
| 233 | +- Added new parameters **CountdownIntervalMins** and **ServerRebootLowRight** to align with the console. |
| 234 | +- Fixed a property name issue for the parameter **NoRebootEnforcement**. |
| 235 | + |
| 236 | +#### Set-CMNotification |
| 237 | + |
| 238 | +For more information, see [Set-CMNotification](/powershell/module/configurationmanager/Set-CMNotification) |
| 239 | + |
| 240 | +**Non-breaking changes** |
| 241 | + |
| 242 | +New alias **InputObject** has been added for parameter **NotificationTasks** which now supports pipeline. |
| 243 | + |
| 244 | +### Module changes |
| 245 | + |
| 246 | +The following folder-related cmdlets now support automatic deployment rules: |
| 247 | + |
| 248 | +- [Get-CMFolder](/powershell/module/configurationmanager/get-cmfolder) |
| 249 | +- [New-CMFolder](/powershell/module/configurationmanager/new-cmfolder) |
| 250 | +- [Remove-CMFolder](/powershell/module/configurationmanager/remove-cmfolder) |
| 251 | +- [Set-CMFolder](/powershell/module/configurationmanager/set-cmfolder) |
| 252 | +- [Move-CMObject](/powershell/module/configurationmanager/move-cmobject) |
| 253 | +- [Add-CMObjectSecurityScope](/powershell/module/configurationmanager/Add-CMObjectSecurityScope) |
| 254 | +- [Remove-CMObjectSecurityScope](/powershell/module/configurationmanager/Remove-CMObjectSecurityScope) |
| 255 | + |
| 256 | +The following cmdlets now have added validation condition for starting or stopping service while CMG is a Virtual Machine Scale Set: |
| 257 | + |
| 258 | +- [Start-CMCloudManagementGateway](/powershell/module/configurationmanager/Start-CMCloudManagementGateway) |
| 259 | +- [Stop-CMCloudManagementGateway](/powershell/module/configurationmanager/Stop-CMCloudManagementGateway) |
| 260 | + |
| 261 | +The following cmdlets have been removed due to the deprecated RA feature: |
| 262 | + |
| 263 | +- [Add-CMCertificateRegistrationPoint](/powershell/module/configurationmanager/Add-CMCertificateRegistrationPoint) |
| 264 | +- [Import-CMClientCertificatePfx](/powershell/module/configurationmanager/Import-CMClientCertificatePfx) |
| 265 | +- [Import-CMWirelessProfileConfigurationItem](/powershell/module/configurationmanager/Import-CMWirelessProfileConfigurationItem) |
| 266 | +- [New-CMCertificateProfilePfx](/powershell/module/configurationmanager/New-CMCertificateProfilePfx) |
| 267 | +- [New-CMCertificateProfileScep](/powershell/module/configurationmanager/New-CMCertificateProfileScep) |
| 268 | +- [New-CMCertificateProfileTrustedRootCA](/powershell/module/configurationmanager/New-CMCertificateProfileTrustedRootCA) |
| 269 | +- [New-CMClientCertificateProfileConfigurationItem](/powershell/module/configurationmanager/New-CMClientCertificateProfileConfigurationItem) |
| 270 | +- [New-CMEmailProfile](/powershell/module/configurationmanager/New-CMEmailProfile) |
| 271 | +- [New-CMRootCertificateProfileConfigurationItem](/powershell/module/configurationmanager/New-CMRootCertificateProfileConfigurationItem) |
| 272 | +- [New-CMVpnProfileConfigurationItem](/powershell/module/configurationmanager/New-CMVpnProfileConfigurationItem) |
| 273 | +- [New-CMWirelessProfile](/powershell/module/configurationmanager/New-CMWirelessProfile) |
| 274 | +- [New-CMWirelessProfileConfigurationItem](/powershell/module/configurationmanager/New-CMWirelessProfileConfigurationItem) |
| 275 | +- [Set-CMCertificateProfilePfx](/powershell/module/configurationmanager/Set-CMCertificateProfilePfx) |
| 276 | +- [Set-CMCertificateProfileScep](/powershell/module/configurationmanager/Set-CMCertificateProfileScep) |
| 277 | +- [Set-CMCertificateProfileTrustedRootCA](/powershell/module/configurationmanager/Set-CMCertificateProfileTrustedRootCA) |
| 278 | +- [Set-CMCertificateRegistrationPoint](/powershell/module/configurationmanager/Set-CMCertificateRegistrationPoint) |
| 279 | +- [Set-CMClientCertificateProfileConfigurationItem](/powershell/module/configurationmanager/Set-CMClientCertificateProfileConfigurationItem) |
| 280 | +- [Set-CMEmailProfile](/powershell/module/configurationmanager/Set-CMEmailProfile) |
| 281 | +- [Set-CMVpnProfileConfigurationItem](/powershell/module/configurationmanager/Set-CMVpnProfileConfigurationItem) |
| 282 | +- [Set-CMWirelessProfile](/powershell/module/configurationmanager/Set-CMWirelessProfile) |
| 283 | +- [Set-CMWirelessProfileConfigurationItem](/powershell/module/configurationmanager/Set-CMWirelessProfileConfigurationItem) |
0 commit comments