Set-CMGlobalCondition
Ändert Einstellungen für eine globale Configuration Manager-Bedingung.
Syntax
Set-CMGlobalCondition
[-Description <String>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-AssemblyName <String>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-Class <String>]
-Name <String>
[-Namespace <String>]
[-PassThru]
[-Property <String>]
[-WhereClause <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
-Name <String>
[-PassThru]
[-UseDefaultInstance]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
-Name <String>
[-PassThru]
[-UseAllInstances]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
[-InstanceName <String>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-DistinguishedName <String>]
[-LdapFilter <String>]
[-LdapPrefix <String>]
-Name <String>
[-PassThru]
[-Property <String>]
[-SearchScope <SearchScope>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-FileOrFolderName <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-Path <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-FilePath <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-FilePath <String>]
-Name <String>
[-PassThru]
[-ScriptLanguage <ScriptingLanguage>]
[-Use32BitHost <Boolean>]
[-UseLoggedOnUserCredential <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-FilePath <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-XmlFilePath <String>]
[-XmlNamespace <String[]>]
[-XPathQuery <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-Is64Bit <Boolean>]
[-KeyName <String>]
-Name <String>
[-PassThru]
[-RegistryHive <RegistryRootKey>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-Is64Bit <Boolean>]
[-KeyName <String>]
-Name <String>
[-PassThru]
[-RegistryHive <RegistryRootKey>]
[-ValueName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
[-MetabasePath <String>]
-Name <String>
[-PassThru]
[-PropertyId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMGlobalCondition
-Name <String>
-OmaUri <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-CMGlobalCondition ändert Einstellungen für eine globale Bedingung. Sie können einen Sicherheitsbereich für eine globale Bedingung hinzufügen oder entfernen. Sie können eine globale Bedingung anhand des Namens oder der ID angeben oder das Cmdlet Get-CMGlobalCondition verwenden, um ein globales Bedingungsobjekt abzurufen.
Configuration Manager verwendet globale Bedingungen, um geschäftliche oder technische Bedingungen darzustellen. Globale Bedingungen geben an, wie Anwendungen auf Clientgeräten bereitgestellt und bereitgestellt werden.
Jede globale Bedingung muss mindestens einen Sicherheitsbereich aufweisen.
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: Hinzufügen eines Sicherheitsbereichs
PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"
Dieser Befehl fügt den Sicherheitsbereich mit dem Namen Scope22 der globalen Bedingung mit dem Namen CPU-Geschwindigkeit hinzu.
Beispiel 2: Entfernen eines Sicherheitsbereichs mithilfe einer Variablen
PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"
Der erste Befehl verwendet das Cmdlet Get-CMGlobalCondition , um die globale Bedingung mit dem Namen CPU-Geschwindigkeit abzurufen und in der variablen $CMGC zu speichern.
Der zweite Befehl entfernt den Sicherheitsbereich mit dem Namen Scope22 aus der globalen Bedingung, die in der variablen $CMGC gespeichert ist.
Parameter
-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: | False |
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: | False |
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: | False |
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: | False |
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 |
-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: | False |
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: | False |
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: | False |
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: | False |
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 |
-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: | False |
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: | False |
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. Die zulässigen Werte für diesen Parameter sind: LDAP:// oder GC://.
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 der globalen Bedingungen an. Dieser Wert entspricht der LocalizedDisplayName-Eigenschaft eines globalen Bedingungsobjekts.
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 |
-NewName
Gibt einen neuen Namen für die globale Bedingung an.
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 |
-PassThru
Gibt das aktuelle Arbeitsobjekt zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Path
Gibt den Pfad für einen OMA-URI an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
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: | False |
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: | False |
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: | False |
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: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SearchScope
Gibt den Suchbereich in AD DS an. Folgende Werte sind für diesen Parameter zulässig:
- Base
- OneLevel
- Teilbaum
Typ: | SearchScope |
Zulässige Werte: | Base, OneLevel, Subtree |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
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 |
-UseAllInstances
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 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UseDefaultInstance
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 |
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: | False |
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: | False |
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: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
System.Object
Ähnliche Themen
- New-CMGlobalCondition
- Get-CMGlobalCondition
- Remove-CMGlobalCondition
- Set-CMGlobalCondition
- Set-CMGlobalConditionAssembly
- Set-CMGlobalConditionFile
- Set-CMGlobalConditionIisMetabase
- Set-CMGlobalConditionOmaUri
- Set-CMGlobalConditionRegistryKey
- Set-CMGlobalConditionRegistryValue
- Set-CMGlobalConditionScript
- Set-CMGlobalConditionSqlQuery
- Set-CMGlobalConditionWqlQuery
- Set-CMGlobalConditionXPathQuery