Set-CMGlobalCondition

Ändert Einstellungen für eine Configuration Manager globale 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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 der globalen Bedingung namens CPU-Geschwindigkeit den Sicherheitsbereich Scope22 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.

Type:String
Position:Named
Default value:None
Required:False
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:False
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:False
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:False
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

-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:False
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:False
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:False
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:False
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

-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:False
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:False
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. Die zulässigen Werte für diesen Parameter sind: LDAP:// oder GC://.

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 der globalen Bedingungen an. Dieser Wert entspricht der LocalizedDisplayName-Eigenschaft eines globalen Bedingungsobjekts.

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

-NewName

Gibt einen neuen Namen für die globale Bedingung an.

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

-PassThru

Gibt das aktuelle Arbeitsobjekt zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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:False
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:False
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:False
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:False
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:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchScope

Gibt den Suchbereich in AD DS an. Folgende Werte sind für diesen Parameter zulässig:

  • Base
  • OneLevel
  • Unterstruktur
Type:SearchScope
Accepted values:Base, OneLevel, Subtree
Position:Named
Default value:None
Required:False
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

-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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
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:False
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:False
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:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

System.Object