Compartir a través de

Set-CMDeviceCollectionVariable

  • Referencia
Módulo:
ConfigurationManager

Configure una variable de recopilación de dispositivos.

Sintaxis

Set-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para cambiar una variable de recopilación de dispositivos.

Las colecciones predeterminadas no pueden tener variables. Cualquier colección de destino debe tener un identificador que comience con el código de sitio, no SMS.

Para obtener más información, vea Cómo establecer variables de secuencia de tareas.

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: Cambio de un nombre de variable

El primer comando obtiene el objeto de colección de dispositivos denominado Device y lo almacena en la variable $Collection .

El segundo comando cambia el nombre de la variable de colección testTS a NewVariable.

$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

Ejemplo 2: Cambio de un valor de variable

Este comando cambia el valor de la variable testTS en la colección Device . Establece el nuevo valor de variable en 12.

Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12

Parámetros

-CollectionId

Especifique el identificador de una colección de dispositivos para configurar una variable. Este valor es la propiedad CollectionID , por ejemplo, XYZ00012. Dado que no se pueden establecer variables en colecciones predeterminadas, este valor comienza con el código del sitio, no SMScon .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CollectionName

Especifique el nombre de una colección de dispositivos para configurar una variable.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
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

-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

-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

-InputObject

Especifique un objeto de colección de dispositivos para configurar una variable. Para obtener este objeto, use los cmdlets Get-CMCollection o Get-CMDeviceCollection .

Tipo:IResultObject
Alias:Collection
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-IsMask

Establezca este parámetro $true en para indicar que el valor de la variable está oculto. Los valores enmascarados no se muestran en la consola de Configuration Manager, la propiedad Value de la clase WMI SMS_CollectionVariable o el archivo de registro de secuencia de tareas. La secuencia de tareas puede seguir usando la variable .

No se puede desenmascarcar una variable una vez que está oculta. Si enmascara el valor de una variable, pero no quiere enmascararla, debe eliminar y volver a crear la variable.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewVariableName

Especifique un nuevo nombre para la variable de colección. Use este parámetro para cambiar el nombre de la variable.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewVariableValue

Especifique un nuevo valor para la variable de colección.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VariableName

Especifique el nombre de la variable de colección que se va a cambiar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object

Notas

Para establecer la prioridad de la variable, use el cmdlet Set-CMCollection con el parámetro VariablePriority . Para ver la prioridad de variable actual, use el cmdlet Get-CMCollectionSetting .