Remove-CMDeviceCollectionVariable

  • Referencia
Módulo:
ConfigurationManager

Quite una variable de recopilación de dispositivos.

Syntax

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 Configuration Manager, por ejemploPS 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 .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

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 para quitar sus variables.

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

-Force

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

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

-VariableName

Especifique el nombre de una variable de colección que se va a quitar. Este parámetro no acepta caracteres comodín.

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

System.Object