Exclui o conteúdo de um item, como o texto de um arquivo, mas não exclui o item.
Sintaxe
Clear-Content [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Clear-Content [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Clear-Content exclui o conteúdo de um item, como o texto de um arquivo, mas não exclui o item. Consequentemente, o item existe, mas está vazio. Clear-Content é semelhante a Clear-Item, mas funciona em arquivos em vez de aliases e variáveis.
Parâmetros
-Credential <PSCredential>
Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual.
Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Exclude <string[]>
Omite os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um elemento ou padrão do caminho, como "*.txt". Os caracteres curinga são permitidos.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Filter <string>
Especifica um filtro no formato ou no idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path. A sintaxe do filtro, incluindo o uso dos caracteres curinga, depende do provedor. Os filtros são mais eficientes do que outros parâmetros porque o provedor os aplica durante a recuperação dos objetos, em vez de fazer com que o Windows PowerShell os filtre depois de recuperados.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Force
Permite que o cmdlet limpe o conteúdo do arquivo mesmo se ele for somente leitura. 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 as restrições de segurança.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Include <string[]>
Limpa somente os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um elemento ou padrão do caminho, como "*.txt". Os caracteres curinga são permitidos.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-LiteralPath <string[]>
Especifica os caminhos até os itens cujo conteúdo foi excluído. Ao contrário de Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Path <string[]>
Especifica os caminhos até os itens cujo conteúdo foi excluído. Os caracteres curinga são permitidos. Eles devem ser caminhos até os itens, e não até os contêineres. Por exemplo, você deve especificar um caminho para um ou mais arquivos, e não um caminho para um diretório. Os caracteres curinga são permitidos. Este parâmetro é obrigatório, mas seu nome ("Path") é opcional.
|
Necessário? |
true |
|
Posição? |
1 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
|
Aceitar caracteres curinga? |
false |
-Confirm
Solicita confirmação antes da execução do comando.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
None Não é possível enviar objetos para Clear-Content. |
|
Saídas |
None Este cmdlet não retorna nenhum objeto. |
Observações
Você também pode fazer referência a Clear-Content usando seu alias interno, "clc". Para obter mais informações, consulte about_Aliases.
Se você omitir o nome do parâmetro -Path, o valor de Path deverá ser o primeiro parâmetro no comando. Por exemplo, "clear-content c:\mydir\*.txt." Se você incluir o nome do parâmetro, poderá listar os parâmetros em qualquer ordem.
Você pode usar Clear-Content com o provedor File System do Windows PowerShell e com outros provedores que manipulam conteúdo. Para limpar itens que não sejam considerados como conteúdo, como os itens gerenciados pelos provedores Certificate ou Registry do Windows PowerShell, use Clear-Item.
O cmdlet Clear-Content foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PsProvider". Para obter mais informações, consulte about_Providers.
Exemplo 1
C:\PS>clear-content ..\SmpUsers\*\init.txt Descrição ----------- Esse comando exclui todo o conteúdo dos arquivos "init.txt" em todos os subdiretórios do diretório SmpUsers. Os arquivos não são excluídos, mas ficam vazios.
Exemplo 2
C:\PS>clear-content -path * -filter *.log -force Descrição ----------- Esse comando exclui o conteúdo de todos os arquivos do diretório atual que tenham a extensão de nome de arquivo ".log", inclusive daqueles com o atributo somente leitura. O asterisco (*) no caminho representa todos os itens do diretório atual. O parâmetro Force faz com que o comando tenha efeito nos arquivos somente para leitura. O uso de um filtro para restringir o comando a arquivos com a extensão ".log", em vez da especificação de "*.log" no caminho, faz com que a operação se torne mais rápida.
Exemplo 3
C:\PS>clear-content c:\Temp\* -Include Smp* -Exclude *2* -whatif Descrição ----------- Esse comando solicita uma previsão do que aconteceria caso você enviasse o comando: "clear-content c:\temp\* -include smp* -exclude *2*". O resultado lista os arquivos que seriam limpos; nesse caso, os arquivos do diretório Temp cujos nomes começam com "Smp", a menos que contenham um "2". Para executar o comando, execute-o novamente sem o parâmetro Whatif.
See Also