Set-CMGlobalCondition

  • Artikel

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

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