Get-CMGlobalCondition

Get-CMGlobalCondition

Gets global condition objects.

Syntax

Parameter Set: SearchByName
Get-CMGlobalCondition [-Name <String[]> ] [-SecuredScopeNames <String> ] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Get-CMGlobalCondition -Id <String[]> [-SecuredScopeNames <String> ] [ <CommonParameters>]

Detailed Description

The Get-CMGlobalCondition cmdlet gets global condition objects. You can pass the results of this cmdlet to the Set-CMGlobalCondition cmdlet or the Remove-CMGlobalCondition cmdlet.

Microsoft System Center 2012 Configuration Manager uses global conditions to represent business or technical conditions. Global conditions specify how to provide and deploy applications to client devices.

You can get global conditions by name, ID, or security scope. You can also specify one or more security scope names with either names or IDs. For instance, you might specify an array of global condition names and specify a security scope to narrow your results.

Parameters

-Id<String[]>

Specifies an array of identifiers of global conditions. This value corresponds to the CI_ID property of a global condition object.

Aliases

CIId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of names for global conditions. This value corresponds to the LocalizedDisplayName property of a global condition object.

Aliases

LocalizedDisplayName

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecuredScopeNames<String>

Specifies a security scope of a global condition. You can use this parameter to narrow your specified global conditions by the current security scope.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Get a global condition by name

This command gets the global condition named CPU speed.

PS C:\> Get-CMGlobalCondition -Name "CPU speed"

Example 2: Get a global condition by name and security scope

This command gets the global condition named CPU speed that has a security scope named Scope22.

PS C:\> Get-CMGlobalCondition -Name "CPU speed" -SecuredScopeNames "Scope22"

Remove-CMGlobalCondition

Set-CMGlobalCondition