New-CMGlobalCondition
Erstellt ein globales Configuration Manager-Bedingungsobjekt.
Syntax
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>] New-CMGlobalCondition
[-AllInstances]
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-AssemblyName <String>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Class <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
[-Namespace <String>]
-Property <String>
[-WhereClause <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-DefaultInstance]
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-InstanceName <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-MetabasePath <String>]
-Name <String>
-PropertyId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-Is64Bit <Boolean>]
-KeyName <String>
-Name <String>
-RegistryHive <RegistryRootKey>
-ValueName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
-ScriptLanguage <ScriptingLanguage>
[-Use32BitHost <Boolean>]
[-UseLoggedOnUserCredential <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 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>] 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>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
-OmaUri <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FileOrFolderName <String>
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
[-IsFolder]
-Name <String>
-Path <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-Is64Bit <Boolean>]
-KeyName <String>
-Name <String>
-RegistryHive <RegistryRootKey>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet New-CMGlobalCondition erstellt eine globale Bedingung in Configuration Manager.
Eine globale Bedingung ist eine Einstellung oder ein Ausdruck in Configuration Manager, mit dem Sie angeben können, wie Configuration Manager eine Anwendung für Clients bereitstellt und bereitstellt.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Erstellen einer globalen Bedingung
PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $WindowsDieser Befehl erstellt eine globale Bedingung, die die Assembly mit dem Namen Microsoft.Office.Tools.Word.v9.0 auf Windows-Geräten durchsucht.
Parameter
-AllInstances
Gibt an, dass die globale Bedingung alle Datenbankinstanzen durchsucht. Um eine benannte Instanz zu durchsuchen, geben Sie den Parameter InstanceName an. Um die Standardinstanz zu durchsuchen, geben Sie den Parameter UseDefaultInstance an .
| Typ: | SwitchParameter |
| Aliase: | UseAllInstances |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AssemblyName
Gibt den Namen einer Assembly an, nach der gesucht werden soll. Ein Assemblyname muss im globalen Assemblycache registriert werden.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Class
Gibt eine WMI-Klasse (Windows Management Instrumentation) an, die zum Erstellen einer WMI-Abfragesprache (WQL) verwendet wird. Die Abfrage bewertet die Konformität auf Clientcomputern.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Column
Gibt den Spaltennamen an, der verwendet wird, um die Konformität der globalen Bedingung zu bewerten.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Database
Gibt den Namen einer Datenbank an. Die SQL-Abfrage wird für diese Datenbank ausgeführt.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DataType
Gibt den globalen Bedingungsdatentyp an. Folgende Werte sind für diesen Parameter zulässig:
- Boolesch
- DateTime
- FloatingPoint
- Ganze Zahl
- IntegerArray
- String
- StringArray
- Version
| Typ: | GlobalConditionDataType |
| Zulässige Werte: | String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DefaultInstance
Gibt an, dass die globale Bedingung die Standarddatenbankinstanz durchsucht. Um eine benannte Instanz zu durchsuchen, geben Sie den Parameter InstanceName an. Um alle Instanzen zu durchsuchen, geben Sie den Parameter UseAllInstances an .
| Typ: | SwitchParameter |
| Aliase: | UseDefaultInstance |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die globale Bedingung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeviceType
Gibt den Gerätetyp an, für den diese globale Bedingung gilt. Die zulässigen Werte für diesen Parameter sind: Nokia, Windows und WindowsMobile.
| Typ: | GlobalConditionDeviceType |
| Zulässige Werte: | Windows, WindowsMobile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DistinguishedName
Gibt den Distinguished Name des Active Directory Domain Services (AD DS)-Objekts an, das auf Clientcomputern auf Konformität bewertet werden soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FileOrFolderName
Gibt den Namen einer Datei oder eines Ordners an. Geben Sie den Parameter IsFolder an, um nach einem Ordner zu suchen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FilePath
Gibt einen Dateipfad für die Datei an, die von der Bedingung auf Konformität bewertet wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-IncludeSubfolder
Gibt an, ob das Cmdlet Unterordner in den Vorgang einschließt.
| Typ: | Boolean |
| Aliase: | IncludeSubfolders |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InstanceName
Gibt den Namen einer Datenbankinstanz an, die von der globalen Bedingung durchsucht wird. Um die Standardinstanz zu durchsuchen, geben Sie den Parameter UseDefaultInstance an . Um alle Instanzen zu durchsuchen, geben Sie den Parameter UseAllInstances an .
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Is64Bit
Gibt an, dass die globale Bedingung zusätzlich zum 32-Bit-Systemdateispeicherort den Speicherort der 64-Bit-Systemdatei durchsucht.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-IsFolder
Gibt an, dass die globale Bedingung nach einem Ordner sucht. Wenn Sie diesen Parameter nicht auswählen, sucht die Bedingung nach einer Datei. Geben Sie den Namen der Datei oder des Ordners mithilfe des Parameters FileOrFolderName an.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-KeyName
Gibt den Namen des Registrierungsschlüssels an, nach dem gesucht werden soll. Verwenden Sie das Format key\subkey.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LdapFilter
Gibt einen LDAP-Filter (Lightweight Directory Access Protocol) zum Verfeinern der Ergebnisse der AD DS-Abfrage an, um die Konformität auf Clientcomputern zu bewerten.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LdapPrefix
Gibt ein gültiges LDAP-Präfix für die AD DS-Abfrage an, die die Konformität auf Clientcomputern bewertet. Dieses Präfix kann entweder LDAP:// oder GC:// sein.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MetabasePath
Gibt den Pfad zur Metabasisdatei für Internetinformationsdienste (IIS) an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Namen einer IIS-Metabasisdatei an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Namespace
Gibt einen Namespace aus einem WMI-Repository an. Der Standardwert ist Root\cimv2.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OmaUri
Gibt einen URI (Uniform Resource Indicator) an, der auf gerätespezifische Parameter für ein Open Mobile Alliance-Gerät (OMA) verweist.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Path
Gibt den Pfad für einen OMA-URI an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Property
Gibt die -Eigenschaft des AD DS-Objekts an, das zum Bewerten der Konformität auf Clientcomputern verwendet wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PropertyId
Gibt die Eigenschaft von AD DS an, die Configuration Manager verwendet, um die Clientkonformität zu bestimmen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RegistryHive
Gibt den Stammschlüssel in der Registrierung an, der die gesuchte Registrierungsstruktur identifiziert. WMI verwendet die Registrierungsstruktur, um die Werte von Registrierungsschlüsseln zurückzugeben, festzulegen und zu ändern. Folgende Werte sind für diesen Parameter zulässig:
- ClassesRoot
- CurrentConfig
- CurrentUser
- LocalMachine
- Benutzer
| Typ: | RegistryRootKey |
| Zulässige Werte: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ScriptLanguage
Gibt eine zu verwendende Skriptsprache an. Folgende Werte sind für diesen Parameter zulässig:
- PowerShell
- VBScript
- JScript
| Typ: | ScriptingLanguage |
| Zulässige Werte: | PowerShell, VBScript, JScript, ShellScript |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SearchScope
Gibt den Suchbereich in AD DS an. Die zulässigen Werte für diesen Parameter sind: Base, OneLevel und Subtree.
| Typ: | SearchScope |
| Zulässige Werte: | Base, OneLevel, Subtree |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Use32BitHost
Gibt an, dass die Datei oder der Ordner einer 64-Bit-Anwendung zugeordnet ist.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseLoggedOnUserCredential
Gibt an, ob Anmeldeinformationen für angemeldete Benutzer verwendet werden sollen.
| Typ: | Boolean |
| Aliase: | UseLoggedOnUserCredentials |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ValueName
Gibt den Wert an, der im angegebenen Registrierungsschlüssel enthalten sein soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhereClause
Gibt eine WHERE-Klausel für eine WQL-Abfrage an, die auf den angegebenen Namespace, die Klasse und die Eigenschaft auf Clientcomputern angewendet werden soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-XmlFilePath
Gibt eine Datei an, die die XML-Abfrage enthält, die zum Bewerten der Konformität auf Clientcomputern verwendet werden soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-XmlNamespace
Gibt ein Array von gültigen, vollständigen XPath-Abfragen (XML Path Language) an, die zur Bewertung der Konformität auf Clientcomputern verwendet werden sollen.
| Typ: | String[] |
| Aliase: | XmlNamespaces |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-XPathQuery
Gibt eine XPath-Abfrage an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject