Share via

Remove-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

Remova uma variável de coleção 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 remover uma variável de coleção de dispositivos. Coleções padrão não podem ter variáveis. Qualquer coleção direcionada deve ter uma ID que comece com o código do site, não SMS.

Para obter mais informações, consulte Como definir variáveis de sequência de tarefas.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: remover uma variável de coleção de dispositivos

O primeiro comando obtém o objeto de coleção de dispositivos chamado Dispositivo e o armazena na variável $Collection .

O segundo comando remove a variável de coleção de dispositivos chamada testTS da coleção de dispositivos armazenada na variável $Collection . Especificar o parâmetro Force indica que você não será solicitado antes que a variável seja removida.

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

Exemplo 2: remover todas as variáveis de uma coleção de dispositivos

Este exemplo usa primeiro o cmdlet Get-CMDeviceCollectionVariable para obter todas as variáveis na coleção de dispositivos Servidores de TI e armazena os objetos na variável de matriz vars . Em seguida, ele faz loops por cada item na matriz e remove a variável por nome.

O parâmetro Force é usado para que você não seja solicitado a remover cada variável.

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

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

Como o parâmetro VariableName não permite curingas, use esse processo se precisar limpar rapidamente todas as variáveis de uma coleção de dispositivos.

Parâmetros

-Collection

Especifique um objeto de coleção de dispositivos para remover suas variáveis. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMDeviceCollection .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CollectionId

Especifique a ID de uma coleção de dispositivos para remover suas variáveis. Esse valor é a propriedade CollectionID , por exemplo, XYZ00012. Como você não pode definir variáveis em coleções padrão, esse valor começa com o código do site, não SMScom .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique o nome de uma coleção de dispositivos para remover suas variáveis.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VariableName

Especifique o nome de uma variável de coleção a ser removida. Esse parâmetro não aceita caracteres curinga.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object