New-CMDeviceCollectionVariable
Cree una variable de recopilación de dispositivos.
Syntax
New-CMDeviceCollectionVariable
-InputObject <IResultObject>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMDeviceCollectionVariable
-CollectionId <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMDeviceCollectionVariable
-CollectionName <String>
[-IsMask <Boolean>]
[-Value <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para crear una variable de recopilación de dispositivos. Puede usar una variable de recopilación de dispositivos para definir variables de secuencia de tareas personalizadas y sus valores asociados que usarán los dispositivos de una colección. Las variables de secuencia de tareas son un conjunto de pares de nombre y valor que proporcionan un mecanismo para configurar y personalizar los pasos de una secuencia de tareas cuando la secuencia de tareas se implementa en una colección específica.
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 Configuration Manager, por ejemploPS XYZ:\>
. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1: Creación de una variable de recopilación de dispositivos
El primer comando obtiene el objeto de colección de dispositivos denominado Device y lo almacena en la variable $Collection .
El segundo comando crea una variable de colección denominada testTS con el valor test001 para el objeto de colección almacenado en $Collection.
$Collection = Get-CMCollection -Name "Device"
New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"
Parámetros
-CollectionId
Especifique el identificador de una colección de dispositivos en la que se va a crear la 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 SMS
con .
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique el nombre de una colección de dispositivos en la que se va a crear la variable.
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 |
-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 |
-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 |
-InputObject
Especifique un objeto de colección de dispositivos en el que se va a crear la variable. Para obtener este objeto, use los cmdlets Get-CMCollection o Get-CMDeviceCollection .
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Si no incluye este parámetro, los valores no se enmascaran de forma predeterminada.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Especifique un valor para la variable de colección.
Type: | String |
Aliases: | VariableValue |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariableName
Especifique un nombre para la variable de colección que se va a crear.
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 |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject[]
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_CollectionSettings clase WMI de servidor.
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