New-CMDeviceCollectionVariable
Criar uma variável de coleção de dispositivos.
Sintaxe
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
Utilize este cmdlet para criar uma variável de coleção de dispositivos. Pode utilizar uma variável de coleção de dispositivos para definir variáveis de sequência de tarefas personalizadas e os respetivos valores associados a serem utilizados pelos dispositivos numa coleção. As variáveis de sequência de tarefas são um conjunto de pares de nomes e valores que fornecem um mecanismo para configurar e personalizar os passos de uma sequência de tarefas quando a sequência de tarefas é implementada numa coleção específica.
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: Criar 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 cria uma variável de coleção denominada testTS com o valor test001 para o objeto de coleção armazenado no $Collection.
$Collection = Get-CMCollection -Name "Device"
New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"Parâmetros
-CollectionId
Especifique o ID de uma coleção de dispositivos na qual pretende criar a variável. 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 na qual pretende criar a variável.
| 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 |
-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 |
-InputObject
Especifique um objeto de coleção de dispositivos no qual pretende criar a variável. Para obter este objeto, utilize os cmdlets Get-CMCollection ou Get-CMDeviceCollection .
| Tipo: | IResultObject |
| Aliases: | Collection |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-IsMask
Defina este parâmetro como $true para indicar que o valor da variável está oculto. Os valores mascarados não são apresentados na consola do Configuration Manager, na propriedade Valor na classe WMI SMS_CollectionVariable ou no ficheiro de registo da sequência de tarefas. A sequência de tarefas ainda pode utilizar a variável .
Não pode desmascarar uma variável depois de estar ocultada. Se mascarar o valor de uma variável, mas não quiser mascará-la, terá de eliminar e recriar a variável.
Se não incluir este parâmetro, os valores não são mascarados por predefinição.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Value
Especifique um valor para a variável de coleção.
| Tipo: | String |
| Aliases: | VariableValue |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VariableName
Especifique um nome para a variável de coleção a criar.
| 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
IResultObject[]
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_CollectionSettings classe WMI de servidor.