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"