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
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 |
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
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 |
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 |
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:
-Valor
Especifica o valor do novo item. Também pode canalizar um valor para o New-Item.
-E se
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
InputsSystem.Object Você pode canalizar um valor para o novo item para o New-Item cmdlet. SaídasSystem.Object New-Item retorna o item que ele cria. NotasO 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.
|