Set-Item
Altera o valor de um item para o valor especificado no comando.
Syntax
Set-Item
[-Path] <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Item
-LiteralPath <String[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Description
O Set-Item
cmdlet altera o valor de um item, como uma variável ou chave do Registro, para o valor especificado no comando .
Exemplos
Exemplo 1: Create um alias
Esse comando cria um alias de np para o Bloco de Notas.
Set-Item -Path alias:np -Value "c:\windows\notepad.exe"
Exemplo 2: alterar o valor de uma variável de ambiente
Esse comando altera o valor da variável de ambiente UserRole para Administrador.
Set-Item -Path env:UserRole -Value "Administrator"
Exemplo 3: Modificar sua função de prompt
Esse comando altera a função de prompt para que ela exiba o tempo antes do caminho.
Set-Item -Path function:prompt -Value {'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '}
Exemplo 4: definir opções para sua função de prompt
Esse comando define as opções AllScope e ReadOnly para a função de prompt.
Esse comando usa o parâmetro dinâmico Opções de Set-Item
.
O parâmetro Options só está disponível quando Set-Item
você o usa com o Alias ou o provedor de funções .
Set-Item -Path function:prompt -Options "AllScope,ReadOnly"
Parâmetros
-Confirm
Solicita sua 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 |
-Credential
Observação
Esse parâmetro não é compatível com nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet exclui na operação. O valor deste parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como *.txt
. Caracteres curinga são permitidos. O parâmetro Exclude só é eficaz quando o comando inclui o conteúdo de um item, como C:\Windows\*
, em que o caractere curinga especifica o conteúdo do C:\Windows
diretório.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Especifica um filtro para qualificar o parâmetro Path . O provedor FileSystem é o único provedor do PowerShell instalado que dá suporte ao uso de filtros. Você pode encontrar a sintaxe da linguagem de filtro FileSystem em about_Wildcards. Os filtros são mais eficientes do que outros parâmetros, pois o provedor os aplica quando o cmdlet obtém os objetos em vez de fazer com que o PowerShell filtre os objetos depois que eles são recuperados.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Força o cmdlet a definir itens que, de outra forma, não podem ser alterados, como alias ou variáveis somente leitura. O cmdlet não pode alterar variáveis nem aliases constantes. A implementação varia de provedor para provedor. Para obter mais informações, consulte about_Providers. Mesmo usando o parâmetro Force , o cmdlet não pode substituir restrições de segurança.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet inclui na operação. O valor deste parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como "*.txt"
. Caracteres curinga são permitidos. O parâmetro Include só é eficaz quando o comando inclui o conteúdo de um item, como C:\Windows\*
, em que o caractere curinga especifica o conteúdo do C:\Windows
diretório.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como ele é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.
Para obter mais informações, consulte about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Options
Esse é um parâmetro dinâmico disponibilizado pelos provedores de Alias e Função . Para obter mais informações, consulte about_Alias_Provider e about_Function_Provider.
Especifica o valor da propriedade Options de um alias.
Os valores válidos são:
None
: o alias não tem restrições (valor padrão)ReadOnly
: o alias pode ser excluído, mas não pode ser alterado sem usar o parâmetro ForceConstant
: o alias não pode ser excluído ou alteradoPrivate
: o alias está disponível apenas no escopo atualAllScope
: o alias é copiado para quaisquer novos escopos criadosUnspecified
: a opção não é especificada
Type: | ScopedItemOptions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Passa um objeto que representa o item para o pipeline. Por padrão, este cmdlet não gera saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Especifica um caminho do local dos itens. Caracteres curinga são permitidos.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Type
Esse é um parâmetro dinâmico disponibilizado pelo provedor do Registro . O provedor do Registro e esse parâmetro só estão disponíveis no Windows.
Especifica o tipo de propriedade que esse cmdlet adiciona. Os valores aceitáveis para esse parâmetro são:
String
: especifica uma cadeia de caracteres terminada em nulo. Usado para valores de REG_SZ .ExpandString
: especifica uma cadeia de caracteres terminada em nulo que contém referências não explicadas a variáveis de ambiente que são expandidas quando o valor é recuperado. Usado para valores REG_EXPAND_SZ .Binary
: especifica dados binários de qualquer forma. Usado para valores de REG_BINARY .DWord
: especifica um número binário de 32 bits. Usado para valores REG_DWORD .MultiString
: especifica uma matriz de cadeias de caracteres terminadas em nulo terminadas por dois caracteres nulos. Usado para valores REG_MULTI_SZ .Qword
: especifica um número binário de 64 bits. Usado para valores de REG_QWORD .Unknown
: indica um tipo de dados do Registro sem suporte, como valores de REG_RESOURCE_LIST .
Type: | RegistryValueKind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Especifica um novo valor para o item.
Type: | Object |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra 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
Você pode redirecionar um objeto que representa o novo valor do item para este cmdlet.
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto que representa o item.
Observações
O PowerShell inclui os seguintes aliases para Set-Item
:
Todas as plataformas:
si
Set-Item
não é compatível com o provedor FileSystem do PowerShell. Para alterar os valores dos itens no sistema de arquivos, use oSet-Content
cmdlet .Nas unidades
HKLM:
do Registro eHKCU:
,Set-Item
altera os dados no valor (Padrão) de uma chave do Registro.- Para criar e alterar os nomes das chaves do Registro, use o
New-Item
cmdlet eRename-Item
. - Para alterar os nomes e os dados nos valores do Registro, use os
New-ItemProperty
cmdlets ,Set-ItemProperty
eRename-ItemProperty
.
- Para criar e alterar os nomes das chaves do Registro, use o
Set-Item
foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digiteGet-PsProvider
. Para obter mais informações, consulte about_Providers.