Delen via


New-CMGlobalCondition

SYNOPSIS

Hiermee maakt u Configuration Manager globale voorwaardeobject.

SYNTAX

NewADQuery (standaard)

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -DistinguishedName <String> -LdapFilter <String>
 [-LdapPrefix <String>] -Name <String> -Property <String> -SearchScope <SearchScope> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewSqlQueryAllInstances

New-CMGlobalCondition [-AllInstances] -Column <String> -Database <String> -DataType <GlobalConditionDataType>
 [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String> -Name <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewAssembly

New-CMGlobalCondition -AssemblyName <String> [-Description <String>] -DeviceType <GlobalConditionDeviceType>
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewWqlQuery

New-CMGlobalCondition -Class <String> -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -Name <String> [-Namespace <String>] -Property <String>
 [-WhereClause <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

NewSqlQueryDefaultInstance

New-CMGlobalCondition -Column <String> -Database <String> -DataType <GlobalConditionDataType>
 [-DefaultInstance] [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String>
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewSqlQuerySpecificInstance

New-CMGlobalCondition -Column <String> -Database <String> -DataType <GlobalConditionDataType>
 [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String> -InstanceName <String>
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewIisMetabase

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> [-MetabasePath <String>] -Name <String> -PropertyId <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewRegistryValue

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> [-Is64Bit <Boolean>] -KeyName <String> -Name <String>
 -RegistryHive <RegistryRootKey> -ValueName <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

NewScript

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -FilePath <String> -Name <String> -ScriptLanguage <ScriptingLanguage>
 [-Use32BitHost <Boolean>] [-UseLoggedOnUserCredential <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewXPathQuery

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -FilePath <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
 -Name <String> [-XmlNamespace <String[]>] -XPathQuery <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewXPathQueryFromFile

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -FilePath <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
 -Name <String> -XmlFilePath <String> [-XmlNamespace <String[]>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewOmaUri

New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
 -DeviceType <GlobalConditionDeviceType> -Name <String> -OmaUri <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewFileSystem

New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType>
 -FileOrFolderName <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] [-IsFolder] -Name <String>
 -Path <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewFileSystemFile

New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String>
 [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] -Name <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

NewRegistryKey

New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType> [-Is64Bit <Boolean>]
 -KeyName <String> -Name <String> -RegistryHive <RegistryRootKey> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet New-CMGlobalCondition maakt een globale voorwaarde in Configuration Manager.

Een globale voorwaarde is een instelling of expressie in Configuration Manager die u kunt gebruiken om op te geven hoe Configuration Manager een toepassing op clients levert en implementeert.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een globale voorwaarde maken

PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows

Met deze opdracht maakt u een globale voorwaarde voor het doorzoeken van de assembly met de naam Microsoft. Office. Tools.Word.v9.0 op Windows apparaten.

PARAMETERS

-AllInstances

Geeft aan dat de globale voorwaarde alle database-exemplaren doorzoekt. Als u een benoemd exemplaar wilt doorzoeken, geeft u de parameter InstanceName op. Als u wilt zoeken in het standaard exemplaar, geeft u de parameter UseDefaultInstance op.

Type: SwitchParameter
Parameter Sets: NewSqlQueryAllInstances
Aliases: UseAllInstances

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AssemblyName

Hiermee geeft u de naam op van een assembly waarvoor moet worden gezocht. Een assemblynaam moet worden geregistreerd in de Global Assembly Cache.

Type: String
Parameter Sets: NewAssembly
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Klasse

Hiermee geeft u Windows WMI-klasse (Management Instrumentation) op die wordt gebruikt om een WMI Query Language (WQL)-query te bouwen. Met de query wordt de naleving op clientcomputers beoordeeld.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Kolom

Hiermee geeft u de kolomnaam op die wordt gebruikt om de naleving van de globale voorwaarde te beoordelen.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DataType

Hiermee geeft u het gegevenstype globale voorwaarde. De aanvaardbare waarden voor deze parameter zijn:

  • Boolean
  • DateTime
  • Floatingpoint
  • Geheel getal
  • Integerarray
  • Tekenreeks
  • StringArray
  • Versie
Type: GlobalConditionDataType
Parameter Sets: NewADQuery, NewSqlQueryAllInstances, NewWqlQuery, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance, NewIisMetabase, NewRegistryValue, NewScript, NewXPathQuery, NewXPathQueryFromFile, NewOmaUri
Aliases:
Accepted values: String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Database

Hiermee geeft u de naam van een database. De SQL query wordt uitgevoerd op deze database.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DefaultInstance

Geeft aan dat de globale voorwaarde het standaarddatabase-exemplaar doorzoekt. Als u een benoemd exemplaar wilt doorzoeken, geeft u de parameter InstanceName op. Als u alle exemplaren wilt doorzoeken, geeft u de parameter UseAllInstances op.

Type: SwitchParameter
Parameter Sets: NewSqlQueryDefaultInstance
Aliases: UseDefaultInstance

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Beschrijving

Hiermee geeft u een beschrijving voor de globale voorwaarde.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeviceType

Hiermee geeft u het type apparaat waarop deze globale voorwaarde van toepassing is. De acceptabele waarden voor deze parameter zijn: Nokia, Windows en WindowsMobile.

Type: GlobalConditionDeviceType
Parameter Sets: (All)
Aliases:
Accepted values: Windows, WindowsMobile

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistinguishedName

Hiermee geeft u de DN-naam op van het Active Directory Domain Services -object (AD DS) dat moet worden beoordeeld op naleving op clientcomputers.

Type: String
Parameter Sets: NewADQuery
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FileOrFolderName

Hiermee geeft u de naam van een bestand of map. Geef de parameter IsFolder op om te zoeken naar een map.

Type: String
Parameter Sets: NewFileSystem
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilePath

Hiermee geeft u een bestandspad op voor het bestand dat door de voorwaarde wordt beoordeeld op naleving.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance, NewScript, NewXPathQuery, NewXPathQueryFromFile, NewFileSystemFile
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncludeSubfolder

Geeft aan of de cmdlet submappen in de bewerking bevat.

Type: Boolean
Parameter Sets: NewXPathQuery, NewXPathQueryFromFile, NewFileSystem, NewFileSystemFile
Aliases: IncludeSubfolders

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InstanceName

Hiermee geeft u de naam op van een database-exemplaar waarin de globale voorwaarde zoekt. Als u wilt zoeken in het standaard exemplaar, geeft u de parameter UseDefaultInstance op. Als u alle exemplaren wilt doorzoeken, geeft u de parameter UseAllInstances op.

Type: String
Parameter Sets: NewSqlQuerySpecificInstance
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Is64Bit

Geeft aan dat de globale voorwaarde de 64-bits systeembestandslocatie naast de 32-bits systeembestandslocatie doorzoekt.

Type: Boolean
Parameter Sets: NewRegistryValue, NewXPathQuery, NewXPathQueryFromFile, NewFileSystem, NewFileSystemFile, NewRegistryKey
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IsFolder

Geeft aan dat de globale voorwaarde zoekt naar een map. Als u deze parameter niet selecteert, zoekt de voorwaarde naar een bestand. Geef de naam van het bestand of de map op met behulp van de parameter FileOrFolderName.

Type: SwitchParameter
Parameter Sets: NewFileSystem
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-KeyName

Hiermee geeft u de naam van de registersleutel op waarvoor moet worden gezocht. Gebruik de indeling sleutel\subsleutel.

Type: String
Parameter Sets: NewRegistryValue, NewRegistryKey
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LdapFilter

Hiermee geeft u een Lightweight Directory Access Protocol filter (LDAP) op om de resultaten van de AD DS query te verfijnen om naleving op clientcomputers te beoordelen.

Type: String
Parameter Sets: NewADQuery
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LdapPrefix

Hiermee geeft u een geldig LDAP-voorvoegsel op voor de AD DS query die de naleving op clientcomputers beoordeelt. Dit voorvoegsel kan worden LDAP:// of GC://.

Type: String
Parameter Sets: NewADQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MetabasePath

Hiermee geeft u het pad naar het metabase-bestand voor Internet Information Services (IIS).

Type: String
Parameter Sets: NewIisMetabase
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Hiermee geeft u de naam van een IIS-metabase-bestand.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Naamruimte

Hiermee geeft u een naamruimte op uit een WMI-opslagplaats. De standaardwaarde is Root\cimv2.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OmaUri

Hiermee geeft u een Uniform Resource Indicator (URI) op die naar apparaatspecifieke parameters voor een OMA-apparaat (Open Mobile Alliance) wijst.

Type: String
Parameter Sets: NewOmaUri
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Path

Hiermee geeft u het pad voor een OMA-URI op.

Type: String
Parameter Sets: NewFileSystem
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Eigenschap

Hiermee geeft u de eigenschap op van het AD DS object dat wordt gebruikt om naleving op clientcomputers te beoordelen.

Type: String
Parameter Sets: NewADQuery, NewWqlQuery
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PropertyId

Hiermee geeft u de eigenschap op van AD DS die Configuration Manager gebruikt om de naleving van de client te bepalen.

Type: String
Parameter Sets: NewIisMetabase
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RegistryHive

Hiermee geeft u de hoofdsleutel in het register die de register-hive die u zoekt identificeert. WMI maakt gebruik van de register-hive om de waarden van registersleutels te retourneren, in te stellen en te wijzigen. De aanvaardbare waarden voor deze parameter zijn:

  • ClassesRoot
  • CurrentConfig
  • CurrentUser
  • LocalMachine
  • Gebruikers
Type: RegistryRootKey
Parameter Sets: NewRegistryValue, NewRegistryKey
Aliases:
Accepted values: ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScriptLanguage

Hiermee geeft u een scripttaal te gebruiken. De aanvaardbare waarden voor deze parameter zijn:

  • PowerShell
  • VBScript
  • JScript
Type: ScriptingLanguage
Parameter Sets: NewScript
Aliases:
Accepted values: PowerShell, VBScript, JScript, ShellScript

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SearchScope

Hiermee geeft u het zoekbereik in AD DS. De acceptabele waarden voor deze parameter zijn: Base, OneLevel en Subtree.

Type: SearchScope
Parameter Sets: NewADQuery
Aliases:
Accepted values: Base, OneLevel, Subtree

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Use32BitHost

Geeft aan dat het bestand of de map is gekoppeld aan een 64-bits toepassing.

Type: Boolean
Parameter Sets: NewScript
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseLoggedOnUserCredential

Geeft aan of aangemelde gebruikersreferenties moeten worden gebruikt.

Type: Boolean
Parameter Sets: NewScript
Aliases: UseLoggedOnUserCredentials

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ValueName

Hiermee geeft u de waarde die moet worden opgenomen in de opgegeven registersleutel.

Type: String
Parameter Sets: NewRegistryValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-WhereClause

Hiermee geeft u een WQL-query WHERE-component moet worden toegepast op de opgegeven naamruimte, klasse en eigenschap op clientcomputers.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-XPathQuery

Hiermee geeft u een XPath-query op.

Type: String
Parameter Sets: NewXPathQuery
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-XmlFilePath

Hiermee geeft u een bestand op dat de XML-query bevat die moet worden gebruikt om naleving op clientcomputers te beoordelen.

Type: String
Parameter Sets: NewXPathQueryFromFile
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-XmlNamespace

Hiermee geeft u een matrix van geldige, volledige XML Path Language -query's (XPath) op die moeten worden gebruikt om naleving op clientcomputers te beoordelen.

Type: String[]
Parameter Sets: NewXPathQuery, NewXPathQueryFromFile
Aliases: XmlNamespaces

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Geen

OUTPUTS

IResultObject#SMS_GlobalCondition

OPMERKINGEN

Get-CMGlobalCondition

Set-CMGlobalCondition

Remove-CMGlobalCondition