Set-CMGlobalCondition
SYNOPSIS
Ändrar inställningarna för ett Konfigurationshanteraren globala villkor.
SYNTAX
SetGeneral (standard)
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
Cmdleten Set-CMGlobalCondition ändrar inställningarna för ett globalt villkor. Du kan lägga till eller ta bort en säkerhetsomfattning för ett globalt villkor. Du kan ange ett globalt villkor efter namn eller ID, eller använda cmdleten Get-CMGlobalCondition för att hämta ett globalt villkorsobjekt.
Konfigurationshanteraren använder globala villkor för att representera affärsvillkor eller tekniska villkor. Globala villkor anger hur program ska tillhandahållas och distribueras till klientenheter.
Varje globalt villkor måste ha minst en säkerhetsomfattning.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Lägga till en säkerhetsomfattning
PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"
Det här kommandot lägger till säkerhetsomfattningen med namnet Scope22 till det globala villkoret med namnet CPU-hastighet.
Exempel 2: Ta bort en säkerhetsomfattning med hjälp av en variabel
PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"
Det första kommandot använder cmdleten Get-CMGlobalCondition för att hämta det globala villkoret med namnet CPU-hastighet och lagra det i $CMGC variabeln.
Det andra kommandot tar bort säkerhetsomfattningen med namnet Scope22 från det globala villkoret som lagras i $CMGC variabeln.
PARAMETERS
-AssemblyName
Anger namnet på en sammansättning som du vill söka efter. Ett sammansättningsnamn måste vara registrerat i den globala sammansättningscachen.
Type: String
Parameter Sets: SetAssembly
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Klass
Anger en Windows WMI-klass (Management Instrumentation) som används för att skapa en WMI Query Language-fråga (WQL). Frågan utvärderar kompatibiliteten på klientdatorer.
Type: String
Parameter Sets: SetWqlQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Kolumn
Anger det kolumnnamn som används för att utvärdera kompatibiliteten för det globala villkoret.
Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Database
Anger namnet på en databas. Den SQL frågan körs på den här databasen.
Type: String
Parameter Sets: SetSqlQueryDefaultInstance, SetSqlQueryAllInstances, SetSqlQuerySpecificInstance
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beskrivning
Anger en beskrivning av det globala villkoret.
Type: String
Parameter Sets: SetGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistinguishedName
Anger det unika namnet på det Active Directory Domain Services (AD DS)-objekt som ska utvärdera kompatibiliteten på klientdatorer.
Type: String
Parameter Sets: SetADQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FileOrFolderName
Anger namnet på en fil eller mapp. Ange parametern IsFolder för att söka efter en mapp.
Type: String
Parameter Sets: SetFileSystem
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FilePath
Anger en filsökväg för filen som villkoret bedömer kompatibiliteten för.
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
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncludeSubfolder
Anger om cmdleten innehåller undermappar i åtgärden.
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
Anger namnet på en databasinstans som det globala villkoret söker efter. Om du vill söka efter standardinstansen anger du parametern UseDefaultInstance. Om du vill söka efter alla instanser anger du parametern UseAllInstances.
Type: String
Parameter Sets: SetSqlQuerySpecificInstance
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Is64Bit
Anger att det globala villkoret söker igenom 64-bitars systemfilsplatsen utöver platsen för 32-bitars systemfil.
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
Anger registernyckelns namn som du vill söka efter. Använd formatet nyckel\undernyckel.
Type: String
Parameter Sets: SetRegistryKey, SetRegistryValue
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LdapFilter
Anger ett Lightweight Directory Access Protocol (LDAP) för att förfina resultaten från AD DS-frågan för att utvärdera kompatibiliteten på klientdatorer.
Type: String
Parameter Sets: SetADQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LdapPrefix
Anger ett giltigt LDAP-prefix för AD DS-frågan som utvärderar kompatibiliteten på klientdatorer. Godkända värden för den här parametern är: LDAP:// eller GC://.
Type: String
Parameter Sets: SetADQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MetabasePath
Anger sökvägen till metabasfilen för 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
Anger namnet på de globala villkoren. Det här värdet motsvarar egenskapen LocalizedDisplayName för ett globalt villkorsobjekt.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Namnområde
Anger ett namnområde från en WMI-lagringsplats. Standardvärdet är Root\cimv2.
Type: String
Parameter Sets: SetWqlQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Anger ett nytt namn för det globala villkoret.
Type: String
Parameter Sets: SetGeneral
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OmaUri
Anger en URI (Uniform Resource Indicator) som pekar på enhetsspecifika parametrar för en OMA-enhet (Open Mobile Alliance).
Type: String
Parameter Sets: SetOmaUri
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Returnerar det aktuella arbetsobjektet. Som standard genererar denna cmdlet inga utdata.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Path
Anger sökvägen för en OMA-URI.
Type: String
Parameter Sets: SetFileSystem
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Egenskap
Anger egenskapen för AD DS-objektet som används för att utvärdera kompatibiliteten på klientdatorer.
Type: String
Parameter Sets: SetWqlQuery, SetADQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PropertyId
Anger egenskapen för AD DS som används Konfigurationshanteraren för att fastställa klientefterlevnad.
Type: String
Parameter Sets: SetIisMetabase
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RegistryHive
Anger rotnyckeln i registret som identifierar registreringsdatafilen som du söker i. WMI använder registreringsdatafilen för att returnera, ange och ändra värdena för registernycklar. De acceptabla värdena för den här parametern är:
- ClassesRoot
- CurrentConfig
- CurrentUser
- LocalMachine
- Användare
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
Anger ett skriptspråk som ska användas. De acceptabla värdena för den här parametern är:
- 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
Anger sökomfånget i AD DS. De acceptabla värdena för den här parametern är:
- Base
- OneLevel
- Underträd
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
Anger att filen eller mappen är associerad med ett 64-bitarsprogram.
Type: Boolean
Parameter Sets: SetScript
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseAllInstances
Anger att det globala villkoret söker igenom alla databasinstanser. Om du vill söka efter en namngiven instans anger du parametern InstanceName. Om du vill söka efter standardinstansen anger du parametern UseDefaultInstance.
Type: SwitchParameter
Parameter Sets: SetSqlQueryAllInstances
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseDefaultInstance
Anger att det globala villkoret söker igenom standarddatabasinstansen. Om du vill söka efter en namngiven instans anger du parametern InstanceName. Om du vill söka efter alla instanser anger du parametern UseAllInstances.
Type: SwitchParameter
Parameter Sets: SetSqlQueryDefaultInstance
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseLoggedOnUserCredential
Anger om du vill använda inloggade användarautentiseringsuppgifter.
Type: Boolean
Parameter Sets: SetScript
Aliases: UseLoggedOnUserCredentials
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValueName
Anger det värde som ska ingå i den angivna registernyckeln.
Type: String
Parameter Sets: SetRegistryValue
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhereClause
Anger en WQL-fråga WHERE-sats som ska tillämpas på angivet namnområde, klass och egenskap på klientdatorer.
Type: String
Parameter Sets: SetWqlQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-XPathQuery
Anger en XPath-fråga.
Type: String
Parameter Sets: SetXPathQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-XmlFilePath
Anger en fil som innehåller DEN XML-fråga som ska användas för att utvärdera kompatibiliteten på klientdatorer.
Type: String
Parameter Sets: SetXPathQuery
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-XmlNamespace
Anger en matris med giltiga XPath-frågor (Full XML Path Language) som ska användas för att utvärdera kompatibiliteten på klientdatorer.
Type: String[]
Parameter Sets: SetXPathQuery
Aliases: XmlNamespaces
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Ingen
OUTPUTS
System.Object
ANTECKNINGAR
RELATED LINKS
Set-CMGlobalConditionIisMetabase
Set-CMGlobalConditionRegistryKey