New-CMGlobalCondition
Создает объект глобального условия Configuration Manager.
Синтаксис
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>] New-CMGlobalCondition
[-AllInstances]
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-AssemblyName <String>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Class <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
[-Namespace <String>]
-Property <String>
[-WhereClause <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-DefaultInstance]
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-Column <String>
-Database <String>
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-InstanceName <String>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-MetabasePath <String>]
-Name <String>
-PropertyId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-Is64Bit <Boolean>]
-KeyName <String>
-Name <String>
-RegistryHive <RegistryRootKey>
-ValueName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
-Name <String>
-ScriptLanguage <ScriptingLanguage>
[-Use32BitHost <Boolean>]
[-UseLoggedOnUserCredential <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 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>] 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>] New-CMGlobalCondition
-DataType <GlobalConditionDataType>
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-Name <String>
-OmaUri <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FileOrFolderName <String>
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
[-IsFolder]
-Name <String>
-Path <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
-FilePath <String>
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMGlobalCondition
[-Description <String>]
-DeviceType <GlobalConditionDeviceType>
[-Is64Bit <Boolean>]
-KeyName <String>
-Name <String>
-RegistryHive <RegistryRootKey>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Командлет New-CMGlobalCondition создает глобальное условие в Configuration Manager.
Глобальное условие — это параметр или выражение в Configuration Manager, которое можно использовать для указания того, как Configuration Manager предоставляет и развертывает приложение для клиентов.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Создание глобального условия
PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $WindowsЭта команда создает глобальное условие, которое выполняет поиск сборки с именем Microsoft.Office.Tools.Word.v9.0 на устройствах Windows.
Параметры
-AllInstances
Указывает, что глобальное условие выполняет поиск по всем экземплярам базы данных. Для поиска именованного экземпляра укажите параметр InstanceName . Для поиска экземпляра по умолчанию укажите параметр UseDefaultInstance .
| Тип: | SwitchParameter |
| Aliases: | UseAllInstances |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-AssemblyName
Указывает имя сборки, для которой выполняется поиск. Имя сборки должно быть зарегистрировано в глобальном кэше сборок.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Class
Указывает класс инструментария управления Windows (WMI), используемый для создания запроса языка запросов WMI (WQL). Запрос оценивает соответствие на клиентских компьютерах.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Column
Указывает имя столбца, используемого для оценки соответствия глобальному условию.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Database
Указывает имя базы данных. Sql-запрос выполняется в этой базе данных.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DataType
Указывает тип данных глобального условия. Допустимые значения для этого параметра:
- Логический
- DateTime
- FloatingPoint
- Integer
- IntegerArray
- String
- StringArray
- Версия
| Тип: | GlobalConditionDataType |
| Допустимые значения: | String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DefaultInstance
Указывает, что глобальное условие выполняет поиск экземпляра базы данных по умолчанию. Для поиска именованного экземпляра укажите параметр InstanceName . Чтобы выполнить поиск по всем экземплярам, укажите параметр UseAllInstances .
| Тип: | SwitchParameter |
| Aliases: | UseDefaultInstance |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Description
Задает описание глобального условия.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DeviceType
Указывает тип устройства, к которому применяется это глобальное условие. Допустимые значения для этого параметра: Nokia, Windows и WindowsMobile.
| Тип: | GlobalConditionDeviceType |
| Допустимые значения: | Windows, WindowsMobile |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DistinguishedName
Указывает различающееся имя объекта доменных служб Active Directory (AD DS) для оценки соответствия на клиентских компьютерах.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-FileOrFolderName
Указывает имя файла или папки. Укажите параметр IsFolder для поиска папки.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-FilePath
Указывает путь к файлу, который условие оценивает на соответствие.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IncludeSubfolder
Указывает, включает ли командлет вложенные папки в операцию.
| Тип: | Boolean |
| Aliases: | IncludeSubfolders |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InstanceName
Указывает имя экземпляра базы данных, в котором выполняется поиск глобального условия. Для поиска экземпляра по умолчанию укажите параметр UseDefaultInstance . Чтобы выполнить поиск по всем экземплярам, укажите параметр UseAllInstances .
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Is64Bit
Указывает, что глобальное условие выполняет поиск по расположению 64-разрядного системного файла в дополнение к расположению 32-разрядного системного файла.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsFolder
Указывает, что глобальное условие выполняет поиск папки. Если этот параметр не выбран, условие выполняет поиск файла. Укажите имя файла или папки с помощью параметра FileOrFolderName .
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-KeyName
Указывает имя раздела реестра, для которого выполняется поиск. Используйте ключ форматирования\подраздел.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-LdapFilter
Задает фильтр LDAP для уточнения результатов запроса AD DS для оценки соответствия на клиентских компьютерах.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-LdapPrefix
Указывает допустимый префикс LDAP для запроса AD DS, который оценивает соответствие на клиентских компьютерах. Этот префикс может быть LDAP:// или GC://.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-MetabasePath
Указывает путь к файлу метабазы для служб IIS.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Указывает имя файла метабазы IIS.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Namespace
Задает пространство имен из репозитория WMI. Значение по умолчанию — Root\cimv2.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-OmaUri
Указывает универсальный индикатор ресурса (URI), указывающий на параметры устройства Open Mobile Alliance (OMA).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Path
Указывает путь для URI OMA.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Property
Указывает свойство объекта AD DS, используемого для оценки соответствия на клиентских компьютерах.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PropertyId
Указывает свойство AD DS, которое Configuration Manager использует для определения соответствия клиентов.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RegistryHive
Указывает корневой раздел в реестре, определяющий куст реестра, который выполняется поиск. WMI использует куст реестра для возврата, задания и изменения значений разделов реестра. Допустимые значения для этого параметра:
- ClassesRoot
- CurrentConfig
- CurrentUser
- LocalMachine
- Пользователи
| Тип: | RegistryRootKey |
| Допустимые значения: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ScriptLanguage
Указывает язык сценариев для использования. Допустимые значения для этого параметра:
- PowerShell
- VBScript
- JScript
| Тип: | ScriptingLanguage |
| Допустимые значения: | PowerShell, VBScript, JScript, ShellScript |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SearchScope
Указывает область поиска в AD DS. Допустимые значения для этого параметра: Base, OneLevel и Subtree.
| Тип: | SearchScope |
| Допустимые значения: | Base, OneLevel, Subtree |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Use32BitHost
Указывает, что файл или папка связаны с 64-разрядным приложением.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UseLoggedOnUserCredential
Указывает, следует ли использовать учетные данные пользователя, выполнившего вход.
| Тип: | Boolean |
| Aliases: | UseLoggedOnUserCredentials |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ValueName
Указывает значение, содержащееся в указанном разделе реестра.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет при этом не запускается.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhereClause
Указывает предложение WQL-запроса WHERE для применения к указанному пространству имен, классу и свойству на клиентских компьютерах.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-XmlFilePath
Указывает файл, содержащий XML-запрос, используемый для оценки соответствия требованиям на клиентских компьютерах.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-XmlNamespace
Задает массив допустимых запросов на языке полного XML-пути (XPath), используемых для оценки соответствия на клиентских компьютерах.
| Тип: | String[] |
| Aliases: | XmlNamespaces |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-XPathQuery
Задает запрос XPath.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
IResultObject