Share via

Get-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

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

Syntax

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

Use esse cmdlet para obter as variáveis de sequência de tarefas em uma 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: Obter uma variável de coleção de dispositivos pelo nome

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

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

Exemplo 2: Obter todas as variáveis 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, ele mostra o nome e o valor de cada variável em uma 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 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:False
Accept wildcard characters:False

-CollectionId

Especifique a ID de uma coleção de dispositivos para obter 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 obter suas variáveis.

Type:String
Position:Named
Default value:None
Required:True
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

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

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

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_CollectionVariable classe WMI do servidor.