Edit

Get-CMSettingDeployment

  • Reference
Module:
ConfigurationManager

Get all of the deployments for a settings policy object.

Syntax

Get-CMSettingDeployment
   [-CMSetting] <CMSettings>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Get all of the deployments for a settings policy object. For example, a BitLocker management policy or a Microsoft Defender Application Control policy. Use the New-CMSettingDeployment to deploy a policy object.

Examples

Example 1: Get all deployments for a BitLocker management setting

This example gets an existing BitLocker management setting object and then uses the pipe operator to get all deployments for that policy object.

Get-CMBlmSetting -Name "My BitLocker setting" | Get-CMSettingDeployment

Example 2: Get all deployments for a Microsoft Defender Application Control setting

This example gets an existing Microsoft Defender Application Control setting object, and then uses the pipe operator to get all deployments for that policy object.

Get-CMWdacSetting -Name "My App Control setting" | Get-CMSettingDeployment

Parameters

-CMSetting

Specify a settings object to get its deployments.

Type:CMSettings
Position:1
Default value:None
Required:True
Accept pipeline input:True
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

-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

Inputs

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings

Outputs

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment