mkdir

Module: Microsoft.PowerShell.Core
Cria um novo item.

Exemplos

————————– EXEMPLO 1 ————————–

PS C:\>new-item -path . -name testfile1.txt -itemtype "file" -value "This is a text string."

Este comando cria um ficheiro de texto chamado testfile1.txt no directório actual. O ponto (.) no valor do parâmetro Path indica o directório actual. O texto citado que segue o parâmetro Value é adicionado ao ficheiro como conteúdo.

————————– EXEMPLO 2 ————————–

PS C:\>new-item -path c:\ -name logfiles -itemtype directory

Este comando cria um directório chamado Logfiles no C: drive. O parâmetro ItemType especifica que o novo item é um directório e não um ficheiro ou outro objecto do sistema de ficheiros.

————————– EXEMPLO 3 ————————–

PS C:\>new-item -path $profile -itemtype file -force

Este comando cria um perfil PowerShell do Windows no caminho que é especificado pela variável $profile.

Você pode usar perfis para personalizar o Windows PowerShell.$Profile é uma variável automática (incorporada) que armazena o caminho e nome do ficheiro do perfil CurrentUser/CurrentHost. Por defeito, o perfil não existe, apesar do Windows PowerShell armazenar um caminho e nome de ficheiro para ele.

Depois de usar este comando para criar um perfil, você pode inserir apelidos, funções e scripts no perfil para personalizar a sua shell.

Para mais informações, veja about_Automatic_Variables e about_Profiles.

————————– EXEMPLO 4 ————————–

PS C:\>new-item -itemtype directory -path c:\ps-test\scripts

Este comando cria um novo diretório de Scripts no diretório C:\PS-Test.

O nome do novo item do diretório, Scripts, está incluído no valor do parâmetro Path, ao invés de ser especificado no valor do parâmetro Name, como indicado pela sintaxe, qualquer um dos comandos é válido.

————————– EXEMPLO 5 ————————–

PS C:\>new-item -itemtype file -path "c:\ps-test\test.txt", "c:\ps-test\Logs\test.log"

Este comando utiliza o cmdlet New-Item para criar ficheiros em dois directórios diferentes.

Parâmetros Requeridos

-Nome

Especifica o nome do novo item.

Pode especificar o nome do novo item no valor do parâmetro Nome ou Caminho, e pode especificar o caminho para o novo item no valor do parâmetro Nome ou Caminho.

Tipo: String
Posição: Nomeado
Valor por omissão: Nenhum
Aceitar entrada de gasoduto: Verdadeiro (ByPropertyName)
Aceitar caracteres wildcard: Falso
-Caminho

Especifica o caminho para a localização do novo item. São permitidos wildcards.

Você pode especificar o nome do novo item no parâmetro Nome, ou incluí-lo no parâmetro Caminho.

Tipo: String
Posição: 1
Valor por omissão: Nenhum
Aceitar entrada de gasoduto: Verdadeiro (ByPropertyName)
Aceitar caracteres wildcard: Falso

Parâmetros opcionais

-Confirmar

Prompta-o para confirmação antes de executar o cmdlet.Prompta-o para confirmação antes de executar o cmdlet.

Tipo: SwitchParameter
Aliases: cf
Posição: Nomeado
Valor por omissão: Falso
Aceitar entrada de gasoduto: Falso
Aceitar caracteres curinga: Falso
-Credencial

Especifica uma conta de usuário que tem permissão para executar esta ação.

Digite um nome de usuário, como “User01” ou “Domain01\User01”, ou digite um objeto PSCredential, como um gerado pelo cmdlet Get-Credential.Se você digitar um nome de usuário, você será solicitado a obter uma senha.

Este parâmetro não é suportado por nenhum provedor instalado com Windows PowerShell

Tipo: PSCredential
Posição: Nomeado
Valor por omissão: Nenhum
Aceitar entrada de gasoduto: Verdadeiro (ByPropertyName)
Aceitar caracteres wildcard: Falso
-Force

Permite que o cmdlet crie um item que escreva sobre um item existente somente leitura. A implementação varia de provedor para provedor. Para mais informações, veja about_Providers.Mesmo usando o parâmetro Force, o cmdlet não pode substituir as restrições de segurança.

Tipo: SwitchParameter
Posição: Nomeado
Valor por omissão: Nenhum
Aceitar entrada de gasoduto: Falso
Aceitar caracteres curinga:
Tipo: SwitchParameter
Aliases: usetx
Posição: Nomeado
Valor por omissão: Falso
Aceitar entrada de gasoduto: Falso
Aceitar caracteres curinga: Falso
-Valor

Especifica o valor do novo item. Também pode canalizar um valor para o New-Item.

Tipo: Objecto
Posição: Nomeado
Valor por omissão: Nenhum
Aceitar entrada de pipeline: Verdadeiro (ByPropertyName, ByValue)
Aceitar caracteres wildcard: Falso
-E se

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

Tipo: SwitchParameter
Aliases: wi
Posição: Nomeado
Valor por omissão: Falso
Aceitar entrada de gasoduto: Falso
Aceitar caracteres curinga: Falso

Inputs

System.Object

Você pode canalizar um valor para o novo item para o New-Item cmdlet.

Saídas

System.Object

New-Item retorna o item que ele cria.

Notas

O New-Item cmdlet foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite “Get-PsProvider”. Para mais informações, veja about_Providers.

  • Clear-Item
  • Copy-Item
  • Get-Item
  • Invoke-Item
  • Move-Item
  • Remove-Item
  • Renamee-Item
  • Set-Item
  • about_Providers

Deixe uma resposta

O seu endereço de email não será publicado.