New-CMDeviceCollectionVariable

  • Referência
Módulo:
ConfigurationManager

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

Syntax

New-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-Value <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-Value <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-Value <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para criar uma variável de coleção de dispositivos. Você pode usar uma variável de coleção de dispositivos para definir variáveis de sequência de tarefas personalizadas e seus valores associados a serem usados pelos dispositivos em uma coleção. As variáveis de sequência de tarefas são um conjunto de pares de nome e valor que fornecem um mecanismo para configurar e personalizar as etapas de uma sequência de tarefas quando a sequência de tarefas é implantada em uma coleção específica.

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: criar 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 cria uma variável de coleção chamada testTS com o valor test001 para o objeto de coleção armazenado em $Collection.

$Collection = Get-CMCollection -Name "Device"
New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"

Parâmetros

-CollectionId

Especifique a ID de uma coleção de dispositivos na qual criar a variável. 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 na qual criar a variável.

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

-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

-InputObject

Especifique um objeto de coleção de dispositivos no qual criar a variável. Para obter esse objeto, use os cmdlets Get-CMCollection ou Get-CMDeviceCollection .

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

-IsMask

Defina esse parâmetro para $true indicar que o valor da variável está oculto. Os valores mascarados não são exibidos no console Configuration Manager, na propriedade Value na classe WMI SMS_CollectionVariable ou no arquivo de log de sequência de tarefas. A sequência de tarefas ainda pode usar a variável.

Não é possível desmascarar uma variável quando ela estiver oculta. Se você mascarar o valor de uma variável, mas não quiser mascarada, precisará excluir e recriar a variável.

Se você não incluir esse parâmetro, os valores não serão mascarados por padrão.

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

-Value

Especifique um valor para a variável de coleção.

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

-VariableName

Especifique um nome para a variável de coleção a ser criada.

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

IResultObject[]

IResultObject

Observações

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