Set-Content

Esse é um parâmetro dinâmico disponibilizado pelo provedor FileSystem. Para obter mais informações, consulte about_FileSystem_Provider.

Especifica que o conteúdo deve ser gravado como um fluxo de bytes. Esse parâmetro foi introduzido no PowerShell 6.0.

Um aviso ocorre quando você usa o parâmetro AsByteStream com o parâmetro Coding . O parâmetro AsByteStream ignora qualquer codificação e a saída é gravada como um fluxo de bytes.

Solicita sua confirmação antes de executar o cmdlet.

Esse é um parâmetro dinâmico disponibilizado pelo provedor FileSystem. Para obter mais informações, consulte about_FileSystem_Provider.

Especifica o tipo de codificação para o arquivo de destino. O valor padrão é utf8NoBOM.

A codificação é um parâmetro dinâmico que o provedor FileSystem adiciona ao Set-Content. Esse parâmetro funciona somente em unidades de sistema de arquivos.

Os valores aceitáveis para este parâmetro são os seguintes:

• ascii: Usa a codificação para o conjunto de caracteres ASCII (7 bits).
• ansi: Usa a codificação para a página de código ANSI da cultura atual. Essa opção foi adicionada no PowerShell 7.4.
• bigendianunicode: Codifica no formato UTF-16 usando a ordem de bytes big-endian.
• bigendianutf32: Codifica no formato UTF-32 usando a ordem de bytes big-endian.
• oem: Usa a codificação padrão para MS-DOS e programas de console.
• unicode: Codifica no formato UTF-16 usando a ordem de bytes little-endian.
• utf7: Codifica no formato UTF-7.
• utf8: Codifica no formato UTF-8.
• utf8BOM: Codifica no formato UTF-8 com Marca de Ordem de Byte (BOM)
• utf8NoBOM: Codifica no formato UTF-8 sem Marca de Ordem de Byte (BOM)
• utf32: Codifica no formato UTF-32.

A partir do PowerShell 6.2, o parâmetro Encoding também permite IDs numéricas de páginas de código registradas (como -Encoding 1251) ou nomes de cadeia de caracteres de páginas de código registradas (como -Encoding "windows-1251"). Para obter mais informações, consulte a documentação do .NET para Encoding.CodePage.

A partir do PowerShell 7.4, você pode usar o Ansi valor do parâmetro Encoding para passar a ID numérica da página de código ANSI da cultura atual sem precisar especificá-la manualmente.

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet exclui na operação. O valor desse 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 é efetivo somente 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.

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.

Força o cmdlet a definir o conteúdo de um arquivo, mesmo que o arquivo seja somente leitura. A implementação varia de provedor para provedor. Para obter mais informações, consulte about_Providers. O parâmetro Force não substitui as restrições de segurança.

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet inclui na operação. O valor desse 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 é efetivo somente 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.

Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. As aspas simples informam ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Para obter mais informações, consulte about_Quoting_Rules.

Esse é um parâmetro dinâmico disponibilizado pelo provedor FileSystem. Para obter mais informações, consulte about_FileSystem_Provider.

As representações de cadeia de caracteres dos objetos de entrada são concatenadas para formar a saída. Nenhum espaço ou nova linha é inserido entre as strings de saída. Nenhuma nova linha é adicionada após a última cadeia de caracteres de saída.

Retorna um objeto que representa o conteúdo. Por padrão, este cmdlet não gera saída.

Especifica o caminho do item que recebe o conteúdo. Caracteres curinga são permitidos.

Esse é um parâmetro dinâmico disponibilizado pelo provedor FileSystem. Este parâmetro está disponível apenas no Windows. Para obter mais informações, consulte about_FileSystem_Provider.

Especifica um fluxo de dados alternativo para o conteúdo. Se o fluxo não existir, esse cmdlet o criará. Não há suporte para caracteres curinga.

Stream é um parâmetro dinâmico que o provedor FileSystem adiciona ao Set-Content. Esse parâmetro funciona somente em unidades de sistema de arquivos.

Você pode usar o Set-Content cmdlet para criar ou atualizar o conteúdo de qualquer fluxo de dados alternativo, como Zone.Identifier. No entanto, não recomendamos isso como uma forma de eliminar as verificações de segurança que bloqueiam arquivos baixados da Internet. Se você verificar se um arquivo baixado é seguro, use o Unblock-File cmdlet.

Esse parâmetro foi introduzido no PowerShell 3.0. A partir do PowerShell 7.2, pode definir o conteúdo de fluxos de dados alternativos de diretórios, Set-Content bem como arquivos.

Especifica o novo conteúdo para o item.

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.