Sdílet prostřednictvím


New-CMGlobalCondition

SYNOPSIS

Vytvoří Správce konfigurace globální podmínky.

SYNTAX

NewADQuery (výchozí)

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>]

Dotaz 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>]

NovýIisMetabase

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>]

Nový_systém_souborů

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

Rutina New-CMGlobalCondition vytvoří globální podmínku v Správce konfigurace.

Globální podmínka je nastavení nebo výraz v Správce konfigurace, který můžete použít k určení způsobu, Správce konfigurace poskytuje a nasazovat aplikace do klientů.

Poznámka

Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: Vytvoření globální podmínky

PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows

Tento příkaz vytvoří globální podmínku, která prohledá sestavení s názvem Microsoft. Office. Tools.Word.v9.0 na Windows zařízeních.

PARAMETERS

-AllInstances

Označuje, že globální podmínka prohledá všechny instance databáze. Pokud chcete vyhledat pojmenovanou instanci, zadejte parametr InstanceName. Pokud chcete vyhledat výchozí instanci, zadejte parametr UseDefaultInstance.

Type: SwitchParameter
Parameter Sets: NewSqlQueryAllInstances
Aliases: UseAllInstances

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

-AssemblyName

Určuje název sestavení, pro které chcete hledat. Název sestavení musí být zaregistrován v globální mezipaměti sestavení (GAC).

Type: String
Parameter Sets: NewAssembly
Aliases:

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

-Class – třída

Určuje třídu Windows Management Instrumentation (WMI) použitou k sestavení dotazu jazyk WQL (WMI Query Language) (WQL). Dotaz posuzuje dodržování předpisů na klientských počítačích.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

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

-Column

Určuje název sloupce, který se použije k vyhodnocení dodržování předpisů globální podmínky.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-DataType

Určuje datový typ globální podmínky. Tento parametr přijímá tyto hodnoty:

  • Logická hodnota
  • Datum a čas
  • Plovoucí desetinná čárka
  • Integer
  • IntegerArray
  • Řetězec
  • Pole řetězce
  • Verze
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

Určuje název databáze. Na SQL se spustí následující dotaz.

Type: String
Parameter Sets: NewSqlQueryAllInstances, NewSqlQueryDefaultInstance, NewSqlQuerySpecificInstance
Aliases:

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

-DefaultInstance

Označuje, že globální podmínka prohledá výchozí instanci databáze. Pokud chcete vyhledat pojmenovanou instanci, zadejte parametr InstanceName. Pokud chcete prohledávat všechny instance, zadejte parametr UseAllInstances.

Type: SwitchParameter
Parameter Sets: NewSqlQueryDefaultInstance
Aliases: UseDefaultInstance

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

-Description (Popis)

Určuje popis globální podmínky.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeviceType

Určuje typ zařízení, na které se tato globální podmínka vztahuje. Přijatelné hodnoty pro tento parametr jsou: Nokia, Windows a 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

Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DistinguishedName

Určuje rozlišující název objektu služby Active Directory Domain Services (AD DS), který se má vyhodnotit pro dodržování předpisů v klientských počítačích.

Type: String
Parameter Sets: NewADQuery
Aliases:

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

-FileOrFolderName

Určuje název souboru nebo složky. Zadáním parametru IsFolder vyhledejte složku.

Type: String
Parameter Sets: NewFileSystem
Aliases:

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

-FilePath

Určuje cestu k souboru, u které podmínka vyhodnotí dodržování předpisů.

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

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IncludeSubfolder

Určuje, jestli rutina obsahuje podsložky operace.

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

Určuje název instance databáze, kterou globální podmínka prohledá. Pokud chcete vyhledat výchozí instanci, zadejte parametr UseDefaultInstance. Pokud chcete prohledávat všechny instance, zadejte parametr UseAllInstances.

Type: String
Parameter Sets: NewSqlQuerySpecificInstance
Aliases:

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

-Is64Bit

Označuje, že globální podmínka hledá kromě umístění 32bitového systémového souboru také umístění 64bitového systémového souboru.

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

Označuje, že globální podmínka hledá složku. Pokud tento parametr nevyberte, podmínka vyhledá soubor. Zadejte název souboru nebo složky pomocí parametru FileOrFolderName.

Type: SwitchParameter
Parameter Sets: NewFileSystem
Aliases:

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

-KeyName

Určuje název klíče registru, pro který se má hledat. Použijte formát klíč\podklíč.

Type: String
Parameter Sets: NewRegistryValue, NewRegistryKey
Aliases:

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

-LdapFilter

Určuje filtr protokolu LDAP (Lightweight Directory Access Protocol), který zpřesní výsledky dotazu služby AD DS za účelem vyhodnocení shody na klientských počítačích.

Type: String
Parameter Sets: NewADQuery
Aliases:

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

-LdapPrefix

Určuje platnou předponu protokolu LDAP pro dotaz služby AD DS, který posuzuje dodržování předpisů na klientských počítačích. Tato předpona může být buď LDAP://, nebo GC://.

Type: String
Parameter Sets: NewADQuery
Aliases:

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

-MetabázePath

Určuje cestu k souboru metabáze pro Internetová informační služba (IIS).

Type: String
Parameter Sets: NewIisMetabase
Aliases:

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

-Name

Určuje název souboru metabáze služby IIS.

Type: String
Parameter Sets: (All)
Aliases:

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

-Namespace

Určuje obor názvů z úložiště wmi. Výchozí hodnota je Root\cimv2.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

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

-OmaUri

Určuje identifikátor URI (Uniform Resource Indicator), který odkazuje na parametry zařízení OMA (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

Určuje cestu pro identifikátor URI OMA.

Type: String
Parameter Sets: NewFileSystem
Aliases:

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

-Property

Určuje vlastnost objektu služby AD DS, který se používá k vyhodnocení dodržování předpisů v klientských počítačích.

Type: String
Parameter Sets: NewADQuery, NewWqlQuery
Aliases:

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

-PropertyId

Určuje vlastnost služby AD DS, kterou Správce konfigurace k určení kompatibility klienta.

Type: String
Parameter Sets: NewIisMetabase
Aliases:

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

-RegistryHive

Určuje kořenový klíč v registru, který identifikuje hledaný podregistr registru. WMI používá podregistr registru k vrácení, nastavení a změně hodnot klíčů registru. Tento parametr přijímá tyto hodnoty:

  • Kořenová třída
  • CurrentConfig
  • Currentuser
  • Místní počítač
  • Uživatelé
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

Určuje skriptovací jazyk, který se má použít. Tento parametr přijímá tyto hodnoty:

  • 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

Určuje obor vyhledávání ve službě AD DS. Přijatelné hodnoty pro tento parametr jsou: Base(Základní), OneLevel (Jedna úroveň) a Subtree (Podstrom).

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

Označuje, že soubor nebo složka jsou přidruženy k 64bitové aplikaci.

Type: Boolean
Parameter Sets: NewScript
Aliases:

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

-UseLoggedOnUserCredential

Určuje, jestli se mají použít přihlašovací údaje přihlášeného uživatele.

Type: Boolean
Parameter Sets: NewScript
Aliases: UseLoggedOnUserCredentials

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

-ValueName

Určuje hodnotu, která má být obsažena v zadaném klíči registru.

Type: String
Parameter Sets: NewRegistryValue
Aliases:

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

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

-WhereClause

Určuje klauzuli WHERE dotazu jazyka WQL, která se použije na zadaný obor názvů, třídu a vlastnost na klientských počítačích.

Type: String
Parameter Sets: NewWqlQuery
Aliases:

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

-XPathQuery

Určuje dotaz XPath.

Type: String
Parameter Sets: NewXPathQuery
Aliases:

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

-XmlFilePath

Určuje soubor, který obsahuje dotaz XML, který se má použít k vyhodnocení dodržování předpisů v klientských počítačích.

Type: String
Parameter Sets: NewXPathQueryFromFile
Aliases:

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

-XmlNamespace

Určuje pole platných úplných dotazů jazyka XPath (XML Path Language), které se mají použít k vyhodnocení dodržování předpisů v klientských počítačích.

Type: String[]
Parameter Sets: NewXPathQuery, NewXPathQueryFromFile
Aliases: XmlNamespaces

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Žádná

OUTPUTS

IResultObject#SMS_GlobalCondition

POZNÁMKY

Get-CMGlobalCondition

Set-CMGlobalCondition

Remove-CMGlobalCondition