New-CMGlobalCondition
Erstellt ein Configuration Manager globale 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, die Sie verwenden können, um anzugeben, wie Configuration Manager eine Anwendung für Clients bereitstellt und bereitstellt.
Hinweis
Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 .
| Type: | SwitchParameter |
| Aliases: | UseAllInstances |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AssemblyName
Gibt den Namen einer Assembly an, nach der gesucht werden soll. Ein Assemblyname muss im globalen Assemblycache registriert werden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Column
Gibt den Spaltennamen an, der verwendet wird, um die Konformität der globalen Bedingung zu bewerten.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Database
Gibt den Namen einer Datenbank an. Die SQL-Abfrage wird für diese Datenbank ausgeführt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataType
Gibt den globalen Bedingungsdatentyp an. Folgende Werte sind für diesen Parameter zulässig:
- Boolesch
- DateTime
- Floatingpoint
- Ganzzahl
- IntegerArray
- Zeichenfolge
- StringArray
- Version
| Type: | GlobalConditionDataType |
| Accepted values: | String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Aliases: | UseDefaultInstance |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für die globale Bedingung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | GlobalConditionDeviceType |
| Accepted values: | Windows, WindowsMobile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistinguishedName
Gibt den Distinguished Name des Active Directory Domain Services -Objekts (AD DS) an, das auf Clientcomputern auf Konformität bewertet werden soll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileOrFolderName
Gibt den Namen einer Datei oder eines Ordners an. Geben Sie den Parameter IsFolder an, um nach einem Ordner zu suchen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilePath
Gibt einen Dateipfad für die Datei an, die von der Bedingung auf Konformität bewertet wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeSubfolder
Gibt an, ob das Cmdlet Unterordner in den Vorgang einschließt.
| Type: | Boolean |
| Aliases: | IncludeSubfolders |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Is64Bit
Gibt an, dass die globale Bedingung zusätzlich zum 32-Bit-Systemdateispeicherort den Speicherort der 64-Bit-Systemdatei durchsucht.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-KeyName
Gibt den Namen des Registrierungsschlüssels an, nach dem gesucht werden soll. Verwenden Sie das Format key\subkey.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MetabasePath
Gibt den Pfad zur Metabasisdatei für Internetinformationsdienste (IIS) an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Namen einer IIS-Metabasisdatei an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Namespace
Gibt einen Namespace aus einem WMI-Repository an. Der Standardwert ist Root\cimv2.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OmaUri
Gibt einen URI (Uniform Resource Indicator) an, der auf gerätespezifische Parameter für ein Open Mobile Alliance-Gerät (OMA) verweist.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Gibt den Pfad für einen OMA-URI an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Property
Gibt die -Eigenschaft des AD DS-Objekts an, das zum Bewerten der Konformität auf Clientcomputern verwendet wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PropertyId
Gibt die Eigenschaft von AD DS an, die Configuration Manager verwendet, um die Clientkonformität zu bestimmen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| Type: | RegistryRootKey |
| Accepted values: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptLanguage
Gibt eine zu verwendende Skriptsprache an. Folgende Werte sind für diesen Parameter zulässig:
- PowerShell
- VBScript
- JScript
| Type: | ScriptingLanguage |
| Accepted values: | PowerShell, VBScript, JScript, ShellScript |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchScope
Gibt den Suchbereich in AD DS an. Die zulässigen Werte für diesen Parameter sind: Base, OneLevel und Subtree.
| Type: | SearchScope |
| Accepted values: | Base, OneLevel, Subtree |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Use32BitHost
Gibt an, dass die Datei oder der Ordner einer 64-Bit-Anwendung zugeordnet ist.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseLoggedOnUserCredential
Gibt an, ob Anmeldeinformationen für angemeldete Benutzer verwendet werden sollen.
| Type: | Boolean |
| Aliases: | UseLoggedOnUserCredentials |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValueName
Gibt den Wert an, der im angegebenen Registrierungsschlüssel enthalten sein soll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XmlFilePath
Gibt eine Datei an, die die XML-Abfrage enthält, die zum Bewerten der Konformität auf Clientcomputern verwendet werden soll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XmlNamespace
Gibt ein Array von gültigen, vollständigen XPath-Abfragen (XML Path Language) an, die zum Bewerten der Konformität auf Clientcomputern verwendet werden sollen.
| Type: | String[] |
| Aliases: | XmlNamespaces |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-XPathQuery
Gibt eine XPath-Abfrage an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
None
Ausgaben
IResultObject
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für