Freigeben über


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