Compartir a través de

Get-CMDeviceCollectionVariable

  • Referencia
Módulo:
ConfigurationManager

Obtenga una variable de recopilación de dispositivos.

Sintaxis

Get-CMDeviceCollectionVariable
   -CollectionName <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -Collection <IResultObject>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -CollectionId <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obtener las variables de secuencia de tareas en una colecció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: Obtención de una variable de recopilación de dispositivos por nombre

Este comando obtiene la variable de colección denominada testTS para la colección de dispositivos denominada Device.

Get-CMDeviceCollectionVariable -CollectionName "DeviceCollection02" -VariableName "testTS"

Ejemplo 2: Obtener todas las variables sin máscara de una colección

En este ejemplo se obtienen todas las variables de los servidores de TI de la colección y se filtra la lista solo a las variables que no están ocultas. A continuación, muestra el nombre y el valor de cada variable de una tabla.

Get-CMDeviceCollectionVariable -CollectionName "IT servers" | Where-Object { -not $_.IsMasked } | Select-Object Name, Value

Parámetros

-Collection

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

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

-CollectionId

Especifique el identificador de una colección de dispositivos para obtener sus variables. 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 obtener sus variables.

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

-VariableName

Especifique el nombre de una variable de colección que se va a obtener.

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

Entradas

None

Salidas

IResultObject[]

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_CollectionVariable clase WMI de servidor.