Compartilhar via

Get-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

Get-CMDeviceCollectionVariable
   -CollectionName <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -Collection <IResultObject>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -CollectionId <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para obter as variáveis de sequência de tarefas numa 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: Obter uma variável de coleção de dispositivos por nome

Este comando obtém a variável de coleção denominada testTS para a coleção de dispositivos denominada Dispositivo.

Get-CMDeviceCollectionVariable -CollectionName "DeviceCollection02" -VariableName "testTS"

Exemplo 2: Obter todas as variáveis não desmascaradas para uma coleção

Este exemplo obtém todas as variáveis dos servidores de TI da coleção e filtra a lista apenas para as variáveis que não estão ocultas. Em seguida, mostra o nome e o valor de cada variável numa tabela.

Get-CMDeviceCollectionVariable -CollectionName "IT servers" | Where-Object { -not $_.IsMasked } | Select-Object Name, Value

Parâmetros

-Collection

Especifique um objeto de coleção de dispositivos para obter as respetivas 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:False
Aceitar caracteres curinga:False

-CollectionId

Especifique o ID de uma coleção de dispositivos para obter 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 obter 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

-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

-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 obter.

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

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_CollectionVariable classe WMI de servidor.