Remove-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

Remover uma variável de coleção de dispositivos.

Sintaxe

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

Utilize este cmdlet para remover uma variável de coleção de dispositivos. As coleções predefinidas não podem ter variáveis. Qualquer coleção que tenha como destino deve ter um ID que comece com o código do site, não SMScom .

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

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja 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 denominado Dispositivo e armazena-o na variável $Collection .

O segundo comando remove a variável de coleção de dispositivos com o nome testTS da coleção de dispositivos armazenada na variável $Collection . Especificar o parâmetro Force indica que não lhe é pedido antes de a variável ser 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 utiliza primeiro o cmdlet Get-CMDeviceCollectionVariable para obter todas as variáveis nos Servidores de TI da coleção de dispositivos e armazena os objetos na variável de matriz vars . Em seguida, percorre cada item na matriz e remove a variável por nome.

O parâmetro Force é utilizado para que não lhe seja pedido para remover cada variável.

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

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

Uma vez que o parâmetro VariableName não permite carateres universais, utilize este processo se precisar de 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 as variáveis. Para obter este objeto, utilize os cmdlets Get-CMCollection ou Get-CMDeviceCollection .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CollectionId

Especifique o ID de uma coleção de dispositivos para remover as respetivas variáveis. Este valor é a propriedade CollectionID , por exemplo, XYZ00012. Uma vez que não pode definir variáveis em coleções predefinidas, este valor começa com o código do site, não SMScom .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem pedir a confirmação do utilizador.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VariableName

Especifique o nome de uma variável de coleção a remover. Este parâmetro não aceita carateres universais.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object