Set-CMDeviceCollectionVariable
Configure uma variável de coleção de dispositivos.
Syntax
Set-CMDeviceCollectionVariable
-InputObject <IResultObject>
[-IsMask <Boolean>]
[-NewVariableName <String>]
[-NewVariableValue <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDeviceCollectionVariable
-CollectionId <String>
[-IsMask <Boolean>]
[-NewVariableName <String>]
[-NewVariableValue <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMDeviceCollectionVariable
-CollectionName <String>
[-IsMask <Boolean>]
[-NewVariableName <String>]
[-NewVariableValue <String>]
-VariableName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use esse cmdlet para alterar uma variável de 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: alterar um nome de variável
O primeiro comando obtém o objeto de coleção de dispositivos chamado Dispositivo e o armazena na variável $Collection .
O segundo comando altera o nome da variável de coleção testTS para NewVariable.
$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"
Exemplo 2: alterar um valor variável
Esse comando altera o valor do testTS variável na coleção Dispositivo . Ele define o novo valor de variável como 12.
Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12
Parâmetros
-CollectionId
Especifique a ID de uma coleção de dispositivos para configurar uma 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 SMS
com .
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 configurar uma 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 para configurar uma 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewVariableName
Especifique um novo nome para a variável de coleção. Use esse parâmetro para renomear a variável.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewVariableValue
Especifique um novo valor para a variável de coleção.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VariableName
Especifique o nome da variável de coleção a ser alterada.
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
System.Object
Observações
Para definir a prioridade da variável, use o cmdlet Set-CMCollection com o parâmetro VariablePriority . Para exibir a prioridade da variável atual, use o cmdlet Get-CMCollectionSetting .
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de