Dela via


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.

INPUTS

Ingen

OUTPUTS

IResultObject#SMS_GlobalCondition

ANTECKNINGAR

Get-CMGlobalCondition

Set-CMGlobalCondition

Remove-CMGlobalCondition