New-CMGlobalCondition
SYNOPSIS
Skapar ett Konfigurationshanteraren globalt villkorsobjekt.
SYNTAX
NewADQuery (standard)
New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> -DistinguishedName <String> -LdapFilter <String>
[-LdapPrefix <String>] -Name <String> -Property <String> -SearchScope <SearchScope> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewSqlQueryAllInstances
New-CMGlobalCondition [-AllInstances] -Column <String> -Database <String> -DataType <GlobalConditionDataType>
[-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String> -Name <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewAssembly
New-CMGlobalCondition -AssemblyName <String> [-Description <String>] -DeviceType <GlobalConditionDeviceType>
-Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewWqlQuery
New-CMGlobalCondition -Class <String> -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> -Name <String> [-Namespace <String>] -Property <String>
[-WhereClause <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
NewSqlQueryDefaultInstance
New-CMGlobalCondition -Column <String> -Database <String> -DataType <GlobalConditionDataType>
[-DefaultInstance] [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String>
-Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewSqlQuerySpecificInstance
New-CMGlobalCondition -Column <String> -Database <String> -DataType <GlobalConditionDataType>
[-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String> -InstanceName <String>
-Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewIisMetabase
New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> [-MetabasePath <String>] -Name <String> -PropertyId <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewRegistryValue
New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> [-Is64Bit <Boolean>] -KeyName <String> -Name <String>
-RegistryHive <RegistryRootKey> -ValueName <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
NewScript
New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> -FilePath <String> -Name <String> -ScriptLanguage <ScriptingLanguage>
[-Use32BitHost <Boolean>] [-UseLoggedOnUserCredential <Boolean>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewXPathQuery
New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> -FilePath <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
-Name <String> [-XmlNamespace <String[]>] -XPathQuery <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewXPathQueryFromFile
New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> -FilePath <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>]
-Name <String> -XmlFilePath <String> [-XmlNamespace <String[]>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewOmaUri
New-CMGlobalCondition -DataType <GlobalConditionDataType> [-Description <String>]
-DeviceType <GlobalConditionDeviceType> -Name <String> -OmaUri <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewFileSystem
New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType>
-FileOrFolderName <String> [-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] [-IsFolder] -Name <String>
-Path <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewFileSystemFile
New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType> -FilePath <String>
[-IncludeSubfolder <Boolean>] [-Is64Bit <Boolean>] -Name <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
NewRegistryKey
New-CMGlobalCondition [-Description <String>] -DeviceType <GlobalConditionDeviceType> [-Is64Bit <Boolean>]
-KeyName <String> -Name <String> -RegistryHive <RegistryRootKey> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Cmdleten New-CMGlobalCondition skapar ett globalt villkor i Konfigurationshanteraren.
Ett globalt villkor är en inställning eller ett uttryck i Konfigurationshanteraren som du kan använda för att ange hur Konfigurationshanteraren tillhandahåller och distribuerar ett program till klienter.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa ett globalt villkor
PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows
Det här kommandot skapar ett globalt villkor som söker igenom sammansättningen Microsoft. Office. Tools.Word.v9.0 på Windows enheter.
PARAMETERS
-AllInstances
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: NewSqlQueryAllInstances
Aliases: UseAllInstances
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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: NewAssembly
Aliases:
Required: True
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: NewWqlQuery
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Kolumn
Anger kolumnnamnet som används för att utvärdera kompatibiliteten för det globala villkoret.
Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:
Required: True
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
-DataType
Anger datatypen globalt villkor. De acceptabla värdena för den här parametern är:
- Boolesk
- DateTime
- Floatingpoint
- Integer
- IntegerArray
- Sträng
- StringArray
- Version
Type: GlobalConditionDataType
Parameter Sets: NewADQuery, NewSqlQueryAllInstances, NewWqlQuery, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance, NewIisMetabase, NewRegistryValue, NewScript, NewXPathQuery, NewXPathQueryFromFile, NewOmaUri
Aliases:
Accepted values: String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml
Required: True
Position: Named
Default value: None
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: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DefaultInstance
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 i alla instanser anger du parametern UseAllInstances.
Type: SwitchParameter
Parameter Sets: NewSqlQueryDefaultInstance
Aliases: UseDefaultInstance
Required: True
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: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeviceType
Anger vilken typ av enhet som det här globala villkoret gäller för. Godkända värden för den här parametern är: Nokia, Windows och WindowsMobile.
Type: GlobalConditionDeviceType
Parameter Sets: (All)
Aliases:
Accepted values: Windows, WindowsMobile
Required: True
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: NewADQuery
Aliases:
Required: True
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: NewFileSystem
Aliases:
Required: True
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 för kompatibilitet.
Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance, NewScript, NewXPathQuery, NewXPathQueryFromFile, NewFileSystemFile
Aliases:
Required: True
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: NewXPathQuery, NewXPathQueryFromFile, NewFileSystem, NewFileSystemFile
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 i alla instanser anger du parametern UseAllInstances.
Type: String
Parameter Sets: NewSqlQuerySpecificInstance
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Is64Bit
Anger att det globala villkoret söker igenom platsen för 64-bitars systemfil förutom platsen för 32-bitars systemfil.
Type: Boolean
Parameter Sets: NewRegistryValue, NewXPathQuery, NewXPathQueryFromFile, NewFileSystem, NewFileSystemFile, NewRegistryKey
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsFolder
Anger att det globala villkoret söker efter en mapp. Om du inte väljer den här parametern söker villkoret efter en fil. Ange namnet på filen eller mappen med hjälp av parametern FileOrFolderName.
Type: SwitchParameter
Parameter Sets: NewFileSystem
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyName
Anger namnet på registernyckeln som du vill söka efter. Använd formatet nyckel\undernyckel.
Type: String
Parameter Sets: NewRegistryValue, NewRegistryKey
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LdapFilter
Anger ett Lightweight Directory Access Protocol (LDAP)-filter för att förfina resultaten från AD DS-frågan för att utvärdera kompatibiliteten på klientdatorer.
Type: String
Parameter Sets: NewADQuery
Aliases:
Required: True
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. Det här prefixet kan vara antingen LDAP:// eller GC://.
Type: String
Parameter Sets: NewADQuery
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: NewIisMetabase
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Anger namnet på en IIS-metabasfil.
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: NewWqlQuery
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: NewOmaUri
Aliases:
Required: True
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: NewFileSystem
Aliases:
Required: True
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: NewADQuery, NewWqlQuery
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PropertyId
Anger egenskapen för AD DS som Konfigurationshanteraren för att fastställa klientefterlevnad.
Type: String
Parameter Sets: NewIisMetabase
Aliases:
Required: True
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: NewRegistryValue, NewRegistryKey
Aliases:
Accepted values: ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Required: True
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: NewScript
Aliases:
Accepted values: PowerShell, VBScript, JScript, ShellScript
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SearchScope
Anger sökomfånget i AD DS. Godkända värden för den här parametern är: Base, OneLevel och Subtree.
Type: SearchScope
Parameter Sets: NewADQuery
Aliases:
Accepted values: Base, OneLevel, Subtree
Required: True
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: NewScript
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: NewScript
Aliases: UseLoggedOnUserCredentials
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValueName
Anger värdet som ska finnas i den angivna registernyckeln.
Type: String
Parameter Sets: NewRegistryValue
Aliases:
Required: True
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: NewWqlQuery
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: NewXPathQuery
Aliases:
Required: True
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: NewXPathQueryFromFile
Aliases:
Required: True
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: NewXPathQuery, NewXPathQueryFromFile
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.