New-CMGlobalCondition
Crea un Configuration Manager objeto de condición global.
Syntax
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>]
Description
El cmdlet New-CMGlobalCondition crea una condición global en Configuration Manager.
Una condición global es una configuración o expresión en Configuration Manager que puede usar para especificar cómo Configuration Manager proporciona e implementa una aplicación en los clientes.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>
. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Creación de una condición global
PS XYZ:\> New-CMGlobalCondition -AssemblyName "Microsoft.Office.Tools.Word.v9.0" -DeviceType $Windows
Este comando crea una condición global que busca el ensamblado denominado Microsoft.Office.Tools.Word.v9.0 en dispositivos Windows.
Parámetros
-AllInstances
Indica que la condición global busca en todas las instancias de base de datos. Para buscar en una instancia con nombre, especifique el parámetro InstanceName . Para buscar en la instancia predeterminada, especifique el parámetro UseDefaultInstance .
Type: | SwitchParameter |
Aliases: | UseAllInstances |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AssemblyName
Especifica el nombre de un ensamblado para el que se va a buscar. Un nombre de ensamblado debe registrarse en la caché global de ensamblados.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Class
Especifica una clase de Instrumental de administración de Windows (WMI) que se usa para compilar una consulta del Lenguaje de consulta WMI (WQL). La consulta evalúa el cumplimiento en los equipos cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Column
Especifica el nombre de columna usado para evaluar el cumplimiento de la condición global.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Database
Especifica el nombre de una base de datos. La consulta SQL se ejecuta en esta base de datos.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DataType
Especifica el tipo de datos de condición global. Los valores aceptables para este parámetro son:
- Boolean
- DateTime
- Punto flotante
- Entero
- IntegerArray
- Cadena
- StringArray
- Versión
Type: | GlobalConditionDataType |
Accepted values: | String, DateTime, Integer, FloatingPoint, Version, Boolean, StringArray, IntegerArray, Base64, Xml |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultInstance
Indica que la condición global busca en la instancia de base de datos predeterminada. Para buscar en una instancia con nombre, especifique el parámetro InstanceName . Para buscar en todas las instancias, especifique el parámetro UseAllInstances .
Type: | SwitchParameter |
Aliases: | UseDefaultInstance |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica una descripción para la condición global.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceType
Especifica el tipo de dispositivo al que se aplica esta condición global. Los valores aceptables para este parámetro son: Nokia, Windows y WindowsMobile.
Type: | GlobalConditionDeviceType |
Accepted values: | Windows, WindowsMobile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistinguishedName
Especifica el nombre distintivo del objeto de Servicios de dominio de Active Directory (AD DS) para evaluar el cumplimiento en los equipos cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileOrFolderName
Especifica el nombre de un archivo o carpeta. Especifique el parámetro IsFolder para buscar una carpeta.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FilePath
Especifica una ruta de acceso de archivo para el archivo que la condición evalúa para el cumplimiento.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeSubfolder
Indica si el cmdlet incluye subcarpetas en la operación.
Type: | Boolean |
Aliases: | IncludeSubfolders |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceName
Especifica el nombre de una instancia de base de datos que busca la condición global. Para buscar en la instancia predeterminada, especifique el parámetro UseDefaultInstance . Para buscar en todas las instancias, especifique el parámetro UseAllInstances .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Is64Bit
Indica que la condición global busca en la ubicación del archivo del sistema de 64 bits, además de en la ubicación del archivo del sistema de 32 bits.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsFolder
Indica que la condición global busca una carpeta. Si no selecciona este parámetro, la condición busca un archivo. Especifique el nombre del archivo o carpeta mediante el parámetro FileOrFolderName .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-KeyName
Especifica el nombre de clave del Registro para el que se va a buscar. Use la clave de formato\subclave.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LdapFilter
Especifica un filtro ligero de protocolo de acceso a directorios (LDAP) para refinar los resultados de la consulta de AD DS para evaluar el cumplimiento en los equipos cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LdapPrefix
Especifica un prefijo LDAP válido para la consulta de AD DS que evalúa el cumplimiento en los equipos cliente. Este prefijo puede ser LDAP:// o GC://.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MetabasePath
Especifica la ruta de acceso al archivo de metabase para Internet Information Services (IIS).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre de un archivo de metabase de IIS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Namespace
Especifica un espacio de nombres de un repositorio WMI. El valor predeterminado es Root\cimv2.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OmaUri
Especifica un indicador uniforme de recursos (URI) que apunta a parámetros específicos del dispositivo para un dispositivo Open Mobile Alliance (OMA).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Especifica la ruta de acceso de un URI de OMA.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Property
Especifica la propiedad del objeto de AD DS que se usa para evaluar el cumplimiento en los equipos cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PropertyId
Especifica la propiedad de AD DS que Configuration Manager usa para determinar el cumplimiento del cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryHive
Especifica la clave raíz en el Registro que identifica el subárbol del Registro en el que se busca. WMI usa el subárbol del Registro para devolver, establecer y cambiar los valores de las claves del Registro. Los valores aceptables para este parámetro son:
- ClassesRoot
- CurrentConfig
- CurrentUser
- LocalMachine
- Usuarios
Type: | RegistryRootKey |
Accepted values: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptLanguage
Especifica un lenguaje de scripting que se va a usar. Los valores aceptables para este parámetro son:
- PowerShell
- VBScript
- JScript
Type: | ScriptingLanguage |
Accepted values: | PowerShell, VBScript, JScript, ShellScript |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SearchScope
Especifica el ámbito de búsqueda en AD DS. Los valores aceptables para este parámetro son: Base, OneLevel y Subtree.
Type: | SearchScope |
Accepted values: | Base, OneLevel, Subtree |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Use32BitHost
Indica que el archivo o carpeta está asociado a una aplicación de 64 bits.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseLoggedOnUserCredential
Indica si se deben usar las credenciales de usuario que han iniciado sesión.
Type: | Boolean |
Aliases: | UseLoggedOnUserCredentials |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValueName
Especifica el valor que se va a incluir en la clave del Registro especificada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhereClause
Especifica una cláusula WHERE de consulta WQL que se aplicará al espacio de nombres, la clase y la propiedad especificados en los equipos cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-XmlFilePath
Especifica un archivo que contiene la consulta XML que se va a usar para evaluar el cumplimiento en los equipos cliente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-XmlNamespace
Especifica una matriz de consultas de lenguaje de ruta de acceso XML completo (XPath) válidas que se van a usar para evaluar el cumplimiento en los equipos cliente.
Type: | String[] |
Aliases: | XmlNamespaces |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-XPathQuery
Especifica una consulta XPath.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Salidas
IResultObject
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de