Set-CMGlobalCondition

Artikel
08/11/2021

SYNOPSIS

Wijzigt instellingen voor een Configuration Manager globale voorwaarde.

SYNTAX

SetGeneral (standaard)

Set-CMGlobalCondition [-Description <String>] -Name <String> [-NewName <String>] [-PassThru]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetAssembly

Set-CMGlobalCondition [-AssemblyName <String>] -Name <String> [-PassThru] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetWqlQuery

Set-CMGlobalCondition [-Class <String>] -Name <String> [-Namespace <String>] [-PassThru] [-Property <String>]
 [-WhereClause <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetSqlQueryDefaultInstance

Set-CMGlobalCondition [-Column <String>] [-Database <String>] [-FilePath <String>] -Name <String> [-PassThru]
 [-UseDefaultInstance] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetSqlQueryAllInstances

Set-CMGlobalCondition [-Column <String>] [-Database <String>] [-FilePath <String>] -Name <String> [-PassThru]
 [-UseAllInstances] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetSqlQuerySpecificInstance

Set-CMGlobalCondition [-Column <String>] [-Database <String>] [-FilePath <String>] [-InstanceName <String>]
 -Name <String> [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetADQuery

Set-CMGlobalCondition [-DistinguishedName <String>] [-LdapFilter <String>] [-LdapPrefix <String>]
 -Name <String> [-PassThru] [-Property <String>] [-SearchScope <SearchScope>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetFileSystem

Set-CMGlobalCondition [-FileOrFolderName <String>] [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
 -Name <String> [-PassThru] [-Path <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SetFileSystemFile

Set-CMGlobalCondition [-FilePath <String>] [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] -Name <String>
 [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetScript

Set-CMGlobalCondition [-FilePath <String>] -Name <String> [-PassThru] [-ScriptLanguage <ScriptingLanguage>]
 [-Use32BitHost <Boolean>] [-UseLoggedOnUserCredential <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetXPathQuery

Set-CMGlobalCondition [-FilePath <String>] [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] -Name <String>
 [-PassThru] [-XmlFilePath <String>] [-XmlNamespace <String[]>] [-XPathQuery <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetRegistryKey

Set-CMGlobalCondition [-Is64Bit <Boolean>] [-KeyName <String>] -Name <String> [-PassThru]
 [-RegistryHive <RegistryRootKey>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SetRegistryValue

Set-CMGlobalCondition [-Is64Bit <Boolean>] [-KeyName <String>] -Name <String> [-PassThru]
 [-RegistryHive <RegistryRootKey>] [-ValueName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetIisMetabase

Set-CMGlobalCondition [-MetabasePath <String>] -Name <String> [-PassThru] [-PropertyId <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetOmaUri

Set-CMGlobalCondition -Name <String> -OmaUri <String> [-PassThru] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Met de cmdlet Set-CMGlobalCondition worden instellingen voor een globale voorwaarde aangepast. U kunt een beveiligingsbereik voor een globale voorwaarde toevoegen of verwijderen. U kunt een globale voorwaarde opgeven op naam of id of de cmdlet Get-CMGlobalCondition gebruiken om een globale voorwaardeobject te verkrijgen.

Configuration Manager globale voorwaarden gebruikt om zakelijke of technische voorwaarden weer te geven. Globale voorwaarden geven aan hoe toepassingen moeten worden verstrekt en geïmplementeerd op clientapparaten.

Elke globale voorwaarde moet ten minste één beveiligingsbereik hebben.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een beveiligingsbereik toevoegen

PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"

Met deze opdracht wordt het beveiligingsbereik scope22 toegevoegd aan de globale voorwaarde met de naam CPU-snelheid.

Voorbeeld 2: Een beveiligingsbereik verwijderen met behulp van een variabele

PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"

De eerste opdracht maakt gebruik van de cmdlet Get-CMGlobalCondition om de globale voorwaarde met de naam CPU-snelheid op te halen en op te slaan in de $CMGC variabele.

Met de tweede opdracht wordt het beveiligingsbereik scope22 verwijderd uit de globale voorwaarde die is opgeslagen in de $CMGC variabele.

PARAMETERS

-AssemblyName

Hiermee geeft u de naam op van een assembly waarvoor moet worden gezocht. Een assemblynaam moet worden geregistreerd in de global assembly-cache.

Type: String
Parameter Sets: SetAssembly
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Klasse

Hiermee geeft u een Windows WMI-klasse (Management Instrumentation) op die wordt gebruikt om een WMI Query Language (WQL)-query te bouwen. Met de query wordt de naleving op clientcomputers beoordeeld.

Type: String
Parameter Sets: SetWqlQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Column

Hiermee geeft u de kolomnaam op die wordt gebruikt om de naleving van de globale voorwaarde te beoordelen.

Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Database

Hiermee geeft u de naam van een database. De SQL query wordt uitgevoerd op deze database.

Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Beschrijving

Hiermee geeft u een beschrijving voor de globale voorwaarde.

Type: String
Parameter Sets: SetGeneral
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DistinguishedName

Hiermee geeft u de DN-naam van het Active Directory Domain Services -object (AD DS) om te beoordelen op naleving op clientcomputers.

Type: String
Parameter Sets: SetADQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FileOrFolderName

Hiermee geeft u de naam van een bestand of map. Geef de parameter IsFolder op om te zoeken naar een map.

Type: String
Parameter Sets: SetFileSystem
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FilePath

Hiermee geeft u een bestandspad op voor het bestand dat door de voorwaarde wordt beoordeeld op naleving.

Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance, SetFileSystemFile, SetScript, SetXPathQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncludeSubfolder

Geeft aan of de cmdlet submappen in de bewerking bevat.

Type: Boolean
Parameter Sets: SetFileSystem, SetFileSystemFile, SetXPathQuery
Aliases: IncludeSubfolders

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InstanceName

Hiermee geeft u de naam op van een database-exemplaar waarin de globale voorwaarde zoekt. Geef de parameter UseDefaultInstance op om te zoeken in het standaard exemplaar. Als u alle exemplaren wilt doorzoeken, geeft u de parameter UseAllInstances op.

Type: String
Parameter Sets: SetSqlQuerySpecificInstance
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Is64Bit

Geeft aan dat de globale voorwaarde de 64-bits systeembestandslocatie naast de 32-bits systeembestandslocatie doorzoekt.

Type: Boolean
Parameter Sets: SetFileSystem, SetFileSystemFile, SetXPathQuery, SetRegistryKey, SetRegistryValue
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-KeyName

Hiermee geeft u de naam van de registersleutel waarvoor u wilt zoeken. Gebruik de indeling sleutel\subsleutel.

Type: String
Parameter Sets: SetRegistryKey, SetRegistryValue
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LdapFilter

Hiermee geeft u een Lightweight Directory Access Protocol (LDAP)-filter op om de resultaten van de AD DS query te verfijnen om naleving op clientcomputers te beoordelen.

Type: String
Parameter Sets: SetADQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-LdapPrefix

Hiermee geeft u een geldig LDAP-voorvoegsel op voor de AD DS query die naleving op clientcomputers beoordeelt. De acceptabele waarden voor deze parameter zijn: LDAP:// of GC://.

Type: String
Parameter Sets: SetADQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-MetabasePath

Hiermee geeft u het pad naar de metabase-bestand voor Internet Information Services (IIS).

Type: String
Parameter Sets: SetIisMetabase
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Hiermee geeft u de naam van de globale voorwaarden. Deze waarde komt overeen met de eigenschap LocalizedDisplayName van een globaal voorwaardeobject.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Naamruimte

Hiermee geeft u een naamruimte op uit een WMI-opslagplaats. De standaardwaarde is Root\cimv2.

Type: String
Parameter Sets: SetWqlQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NewName

Hiermee geeft u een nieuwe naam voor de globale voorwaarde.

Type: String
Parameter Sets: SetGeneral
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OmaUri

Hiermee geeft u een Uniform Resource Indicator (URI) op die naar apparaatspecifieke parameters voor een OMA-apparaat (Open Mobile Alliance) wijst.

Type: String
Parameter Sets: SetOmaUri
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Retourneert het huidige werkende object. Deze cmdlet genereert standaard geen uitvoer.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Path

Hiermee geeft u het pad voor een OMA-URI op.

Type: String
Parameter Sets: SetFileSystem
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Eigenschap

Hiermee geeft u de eigenschap op van het AD DS object dat wordt gebruikt om naleving op clientcomputers te beoordelen.

Type: String
Parameter Sets: SetWqlQuery, SetADQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PropertyId

Hiermee geeft u de eigenschap op van AD DS die Configuration Manager gebruikt om de naleving van de client te bepalen.

Type: String
Parameter Sets: SetIisMetabase
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RegistryHive

Hiermee geeft u de hoofdsleutel in het register die de register-hive die u zoekt identificeert. WMI maakt gebruik van de register-hive om de waarden van registersleutels te retourneren, in te stellen en te wijzigen. De aanvaardbare waarden voor deze parameter zijn:

KlassenRoot
CurrentConfig
CurrentUser
LocalMachine
Gebruikers

Type: RegistryRootKey
Parameter Sets: SetRegistryKey, SetRegistryValue
Aliases:
Accepted values: ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScriptLanguage

Hiermee geeft u een scripttaal te gebruiken. De aanvaardbare waarden voor deze parameter zijn:

PowerShell
VBScript
JScript

Type: ScriptingLanguage
Parameter Sets: SetScript
Aliases:
Accepted values: PowerShell, VBScript, JScript, ShellScript

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SearchScope

Hiermee geeft u het zoekbereik in AD DS. De aanvaardbare waarden voor deze parameter zijn:

Base
OneLevel
Substructuur

Type: SearchScope
Parameter Sets: SetADQuery
Aliases:
Accepted values: Base, OneLevel, Subtree

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Use32BitHost

Geeft aan dat het bestand of de map is gekoppeld aan een 64-bits toepassing.

Type: Boolean
Parameter Sets: SetScript
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseAllInstances

Geeft aan dat de globale voorwaarde alle database-exemplaren doorzoekt. Als u een benoemd exemplaar wilt doorzoeken, geeft u de parameter InstanceName op. Als u wilt zoeken in het standaard exemplaar, geeft u de parameter UseDefaultInstance op.

Type: SwitchParameter
Parameter Sets: SetSqlQueryAllInstances
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultInstance

Geeft aan dat de globale voorwaarde het standaarddatabase-exemplaar doorzoekt. Als u een benoemd exemplaar wilt doorzoeken, geeft u de parameter InstanceName op. Als u alle exemplaren wilt doorzoeken, geeft u de parameter UseAllInstances op.

Type: SwitchParameter
Parameter Sets: SetSqlQueryDefaultInstance
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseLoggedOnUserCredential

Geeft aan of aangemelde gebruikersreferenties moeten worden gebruikt.

Type: Boolean
Parameter Sets: SetScript
Aliases: UseLoggedOnUserCredentials

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ValueName

Hiermee geeft u de waarde die moet worden opgenomen in de opgegeven registersleutel.

Type: String
Parameter Sets: SetRegistryValue
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-WhereClause

Hiermee geeft u een WQL-query WHERE-component moet worden toegepast op de opgegeven naamruimte, klasse en eigenschap op clientcomputers.

Type: String
Parameter Sets: SetWqlQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-XPathQuery

Hiermee geeft u een XPath-query op.

Type: String
Parameter Sets: SetXPathQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-XmlFilePath

Hiermee geeft u een bestand op dat de XML-query bevat die moet worden gebruikt om de naleving op clientcomputers te beoordelen.

Type: String
Parameter Sets: SetXPathQuery
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-XmlNamespace

Hiermee geeft u een matrix met geldige XPath-query's (Full XML Path Language) op die moeten worden gebruikt om de naleving op clientcomputers te beoordelen.

Type: String[]
Parameter Sets: SetXPathQuery
Aliases: XmlNamespaces

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.