Compartir a través de

Remove-CMDeviceCollectionVariable

  • Referencia
Módulo:
ConfigurationManager

Quite una variable de recopilación de dispositivos.

Sintaxis

Remove-CMDeviceCollectionVariable
      -Collection <IResultObject>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionId <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeviceCollectionVariable
      -CollectionName <String>
      [-Force]
      -VariableName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use este cmdlet para quitar 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: Eliminació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 quita la variable de recopilación de dispositivos denominada testTS de la colección de dispositivos almacenada en la variable $Collection . La especificación del parámetro Force indica que no se le pedirá antes de quitar la variable.

$Collection = Get-CMCollection -Name "Device"
Remove-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Force

Ejemplo 2: Eliminación de todas las variables de una colección de dispositivos

En este ejemplo, primero se usa el cmdlet Get-CMDeviceCollectionVariable para obtener todas las variables en los servidores de TI de la colección de dispositivos y se almacenan los objetos en la variable de matriz vars . A continuación, recorre en bucle cada elemento de la matriz y quita la variable por nombre.

El parámetro Force se usa para que no se le pida que quite cada variable.

$collName = "IT servers"
$vars = Get-CMDeviceCollectionVariable -CollectionName $collName

foreach ( $var in $vars ) {
  Remove-CMDeviceCollectionVariable -CollectionName $collName -VariableName $var -Force
}

Dado que el parámetro VariableName no permite caracteres comodín, use este proceso si necesita borrar rápidamente todas las variables de una colección de dispositivos.

Parámetros

-Collection

Especifique un objeto de colección de dispositivos para quitar 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:True
Aceptar caracteres comodín:False

-CollectionId

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

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

-Force

Obliga al comando a ejecutarse sin pedir confirmación del usuario.

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 quitar. Este parámetro no acepta caracteres comodín.

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