Set-CMGlobalCondition
Modifica la configuración de una condición global de Configuration Manager.
Sintaxis
Set-CMGlobalCondition
[-Description <String>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-AssemblyName <String>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Class <String>]
-Name <String>
[-Namespace <String>]
[-PassThru]
[-Property <String>]
[-WhereClause <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
-Name <String>
[-PassThru]
[-UseDefaultInstance]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
-Name <String>
[-PassThru]
[-UseAllInstances]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Column <String>]
[-Database <String>]
[-FilePath <String>]
[-InstanceName <String>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-DistinguishedName <String>]
[-LdapFilter <String>]
[-LdapPrefix <String>]
-Name <String>
[-PassThru]
[-Property <String>]
[-SearchScope <SearchScope>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FileOrFolderName <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-Path <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FilePath <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FilePath <String>]
-Name <String>
[-PassThru]
[-ScriptLanguage <ScriptingLanguage>]
[-Use32BitHost <Boolean>]
[-UseLoggedOnUserCredential <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-FilePath <String>]
[-IncludeSubfolder <Boolean>]
[-Is64Bit <Boolean>]
-Name <String>
[-PassThru]
[-XmlFilePath <String>]
[-XmlNamespace <String[]>]
[-XPathQuery <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Is64Bit <Boolean>]
[-KeyName <String>]
-Name <String>
[-PassThru]
[-RegistryHive <RegistryRootKey>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-Is64Bit <Boolean>]
[-KeyName <String>]
-Name <String>
[-PassThru]
[-RegistryHive <RegistryRootKey>]
[-ValueName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
[-MetabasePath <String>]
-Name <String>
[-PassThru]
[-PropertyId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMGlobalCondition
-Name <String>
-OmaUri <String>
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet Set-CMGlobalCondition modifica la configuración de una condición global. Puede agregar o quitar un ámbito de seguridad para una condición global. Puede especificar una condición global por nombre o identificador, o bien usar el cmdlet Get-CMGlobalCondition para obtener un objeto de condición global.
Configuration Manager usa condiciones globales para representar condiciones empresariales o técnicas. Las condiciones globales especifican cómo proporcionar e implementar aplicaciones en dispositivos cliente.
Cada condición global debe tener al menos un ámbito de seguridad.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Adición de un ámbito de seguridad
PS XYZ:\> Set-CMGlobalCondition -Name "CPU speed" -SecurityScopeAction AddMembership -SecurityScopeName "Scope22"Este comando agrega el ámbito de seguridad denominado Scope22 a la condición global denominada velocidad de CPU.
Ejemplo 2: Eliminación de un ámbito de seguridad mediante una variable
PS XYZ:\> $CMGC = Get-CMGlobalCondition -Name "CPU speed"
PS XYZ:\> Set-CMGlobalCondition -InputObject $CMGC -SecurityScopeAction RemoveMembership -SecurityScopeName "Scope22"El primer comando usa el cmdlet Get-CMGlobalCondition para obtener la condición global denominada velocidad de CPU y almacenarla en la variable $CMGC.
El segundo comando quita el ámbito de seguridad denominado Scope22 de la condición global almacenada en la variable $CMGC.
Parámetros
-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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Column
Especifica el nombre de columna usado para evaluar el cumplimiento de la condición global.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Database
Especifica el nombre de una base de datos. La consulta SQL se ejecuta en esta base de datos.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Description
Especifica una descripción para la condición global.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DistinguishedName
Especifica el nombre distintivo del objeto de Active Directory Domain Services (AD DS) para evaluar el cumplimiento en los equipos cliente.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FileOrFolderName
Especifica el nombre de un archivo o carpeta. Especifique el parámetro IsFolder para buscar una carpeta.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FilePath
Especifica una ruta de acceso de archivo para el archivo que la condición evalúa para el cumplimiento.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IncludeSubfolder
Indica si el cmdlet incluye subcarpetas en la operación.
| Tipo: | Boolean |
| Alias: | IncludeSubfolders |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-KeyName
Especifica el nombre de clave del Registro para el que se va a buscar. Use la clave de formato\subclave.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-LdapPrefix
Especifica un prefijo LDAP válido para la consulta de AD DS que evalúa el cumplimiento en los equipos cliente. Los valores aceptables para este parámetro son: LDAP:// o GC://.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MetabasePath
Especifica la ruta de acceso al archivo de metabase para Internet Information Services (IIS).
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifica el nombre de las condiciones globales. Este valor corresponde a la propiedad LocalizedDisplayName de un objeto de condición global.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Namespace
Especifica un espacio de nombres de un repositorio WMI. El valor predeterminado es Root\cimv2.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-NewName
Especifica un nuevo nombre para la condición global.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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).
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PassThru
Devuelve el objeto de trabajo actual. De forma predeterminada, este cmdlet no genera resultados.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Path
Especifica la ruta de acceso de un URI de OMA.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Property
Especifica la propiedad del objeto de AD DS que se usa para evaluar el cumplimiento en los equipos cliente.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PropertyId
Especifica la propiedad de AD DS que Configuration Manager usa para determinar el cumplimiento del cliente.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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
| Tipo: | RegistryRootKey |
| Valores aceptados: | ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ScriptLanguage
Especifica un lenguaje de scripting que se va a usar. Los valores aceptables para este parámetro son:
- PowerShell
- VBScript
- JScript
| Tipo: | ScriptingLanguage |
| Valores aceptados: | PowerShell, VBScript, JScript, ShellScript |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SearchScope
Especifica el ámbito de búsqueda en AD DS. Los valores aceptables para este parámetro son:
- Base
- OneLevel
- Subárbol
| Tipo: | SearchScope |
| Valores aceptados: | Base, OneLevel, Subtree |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Use32BitHost
Indica que el archivo o carpeta está asociado a una aplicación de 64 bits.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UseAllInstances
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 .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UseDefaultInstance
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 .
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UseLoggedOnUserCredential
Indica si se deben usar las credenciales de usuario que han iniciado sesión.
| Tipo: | Boolean |
| Alias: | UseLoggedOnUserCredentials |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ValueName
Especifica el valor que se va a incluir en la clave del Registro especificada.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-XmlFilePath
Especifica un archivo que contiene la consulta XML que se va a usar para evaluar el cumplimiento en los equipos cliente.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | String[] |
| Alias: | XmlNamespaces |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-XPathQuery
Especifica una consulta XPath.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
System.Object
Vínculos relacionados
- New-CMGlobalCondition
- Get-CMGlobalCondition
- Remove-CMGlobalCondition
- Set-CMGlobalCondition
- Set-CMGlobalConditionAssembly
- Set-CMGlobalConditionFile
- Set-CMGlobalConditionIisMetabase
- Set-CMGlobalConditionOmaUri
- Set-CMGlobalConditionRegistryKey
- Set-CMGlobalConditionRegistryValue
- Set-CMGlobalConditionScript
- Set-CMGlobalConditionSqlQuery
- Set-CMGlobalConditionWqlQuery
- Set-CMGlobalConditionXPathQuery