Copy-Item
Copia um item de um local para outro.
Sintaxe
Path (Default) - FileSystem provider
Copy-Item
[-Path] <String[]>
[[-Destination] <String>]
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-FromSession <PSSession>]
[-ToSession <PSSession>]
[<CommonParameters>]
LiteralPath - FileSystem provider
Copy-Item
[[-Destination] <String>]
-LiteralPath <String[]>
[-Container]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Recurse]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-FromSession <PSSession>]
[-ToSession <PSSession>]
[<CommonParameters>]
Path (Default) - All providers
Copy-Item
[-Path] <string[]>
[[-Destination] <string>]
[-Container]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-PassThru]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
LiteralPath - All providers
Copy-Item
[[-Destination] <string>]
-LiteralPath <string[]>
[-Container]
[-Force]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Recurse]
[-PassThru]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Copy-Item copia um item de um local para outro no mesmo namespace.
Por exemplo, ele pode copiar um arquivo para uma pasta, mas não pode copiar um arquivo para uma unidade de certificado.
Este cmdlet não corta nem exclui os itens que estão sendo copiados. Os itens específicos que o cmdlet pode copiar dependem do provedor do PowerShell que expõe o item. Por exemplo, ele pode copiar arquivos e diretórios em uma unidade do sistema de arquivos e chaves de registro e entradas na unidade de registro.
Este cmdlet pode copiar e renomear itens no mesmo comando. Para renomear um item, insira o novo nome no valor do parâmetro Destination. Para renomear um item e não copiá-lo, use o cmdlet Rename-Item.
Exemplos
Exemplo 1: Copiar um arquivo para o diretório especificado
Este exemplo copia o arquivo mar1604.log.txt para o diretório C:\Presentation. O ficheiro original não é eliminado.
Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"
Exemplo 2: Copiar o conteúdo do diretório para um diretório existente
Este exemplo copia o conteúdo do diretório C:\Logfiles para o diretório C:\Drawings existente. O diretório Logfiles não é copiado.
Se o diretório Logfiles tiver arquivos em subdiretórios, esses subdiretórios serão copiados com suas árvores de arquivos intactas. Por padrão, o parâmetro Container é definido como True, que preserva a estrutura de diretórios.
Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -Recurse
Observação
Se o caminho C:\Drawings não existir, o cmdlet copiará todos os arquivos da árvore de pastas Logfiles para uma única pasta C:\Drawings, substituindo todos os arquivos com o mesmo nome.
Exemplo 3: Copiar diretório e conteúdo para um novo diretório
Este exemplo copia o conteúdo do diretório de origem C:\Logfiles e cria um novo diretório de destino. O novo diretório de destino, \Logs é criado em C:\Drawings.
Para incluir o nome do diretório de origem, copie para um diretório de destino existente, conforme mostrado no Exemplo 2. Ou, nomeie o novo diretório de destino com o mesmo que o diretório de origem.
Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings\Logs" -Recurse
Observação
Se o Caminho do incluir \*, todo o conteúdo do arquivo do diretório, incluindo as árvores do subdiretório, será copiado para o novo diretório de destino. Por exemplo:
Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse
Exemplo 4: Copiar um arquivo para o diretório especificado e renomear o arquivo
Este exemplo usa o cmdlet Copy-Item para copiar o script Get-Widget.ps1 do diretório \\Server01\Share para o diretório \\Server12\ScriptArchive. Como parte da operação de cópia, o comando altera o nome do item de Get-Widget.ps1 para Get-Widget.ps1.txt, para que possa ser anexado com segurança às mensagens de e-mail.
$copyParams = @{
Path = "\\Server01\Share\Get-Widget.ps1"
Destination = "\\Server12\ScriptArchive\Get-Widget.ps1.txt"
}
Copy-Item @copyParams
Exemplo 5: Copiar um ficheiro para um computador remoto
Uma sessão é criada no computador remoto chamado Server01 com a credencial de Contoso\User01 e armazena os resultados na variável chamada $Session.
O cmdlet Copy-Item copia test.log da pasta D:\Folder001 para a pasta C:\Folder001_Copy no computador remoto usando as informações de sessão armazenadas na variável $Session. O ficheiro original não é eliminado.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "D:\Folder001\test.log" -Destination "C:\Folder001_Copy\" -ToSession $Session
Exemplo 6: Copiar uma pasta para um computador remoto
Uma sessão é criada no computador remoto chamado Server01 com a credencial de Contoso\User01 e armazena os resultados na variável chamada $Session.
O cmdlet Copy-Item copia a pasta D:\Folder002 para o diretório C:\Folder002_Copy no computador remoto usando as informações de sessão armazenadas na variável $Session. As subpastas ou arquivos não são copiados sem usar a opção Recurse. A operação cria a pasta Folder002_Copy se ela ainda não existir.
$Session = New-PSSession -ComputerName "Server02" -Credential "Contoso\User01"
Copy-Item "D:\Folder002\" -Destination "C:\Folder002_Copy\" -ToSession $Session
Exemplo 7: Copiar recursivamente todo o conteúdo de uma pasta para um computador remoto
Uma sessão é criada no computador remoto chamado Server01 com a credencial de Contoso\User01 e armazena os resultados na variável chamada $Session.
O cmdlet Copy-Item copia todo o conteúdo da pasta D:\Folder003 para o diretório C:\Folder003_Copy no computador remoto usando as informações de sessão armazenadas na variável $Session. As subpastas são copiadas com suas árvores de arquivos intactas. A operação cria a pasta Folder003_Copy se ela ainda não existir.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
Copy-Item "D:\Folder003\" -Destination "C:\Folder003_Copy\" -ToSession $Session -Recurse
Exemplo 8: Copiar um ficheiro para um computador remoto e, em seguida, mudar o nome do ficheiro
Uma sessão é criada no computador remoto chamado Server01 com a credencial de Contoso\User01 e armazena os resultados na variável chamada $Session.
O cmdlet Copy-Item copia scriptingexample.ps1 da pasta D:\Folder004 para a pasta C:\Folder004_Copy no computador remoto usando as informações de sessão armazenadas na variável $Session. O ficheiro original não é eliminado.
$Session = New-PSSession -ComputerName "Server04" -Credential "Contoso\User01"
$copyParams = @{
Path = "D:\Folder004\scriptingexample.ps1"
Destination = "C:\Folder004_Copy\scriptingexample_copy.ps1"
ToSession = $Session
}
Copy-Item @copyParams
Exemplo 9: Copiar um ficheiro remoto para o computador local
Uma sessão é criada no computador remoto chamado Server01 com a credencial de Contoso\User01 e armazena os resultados na variável chamada $Session.
O cmdlet Copy-Item copia test.log do C:\MyRemoteData\ remoto para a pasta D:\MyLocalData local usando as informações de sessão armazenadas na variável $Session. O ficheiro original não é eliminado.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\test.log" -Destination "D:\MyLocalData\" -FromSession $Session
Exemplo 10: Copiar todo o conteúdo de uma pasta remota para o computador local
Uma sessão é criada no computador remoto chamado Server01 com a credencial de Contoso\User01 e armazena os resultados na variável chamada $Session.
O cmdlet Copy-Item copia todo o conteúdo da pasta C:\MyRemoteData\scripts remota para a pasta D:\MyLocalData local usando as informações de sessão armazenadas na variável $Session. Se a pasta scripts tiver arquivos em subpastas, essas subpastas serão copiadas com suas árvores de arquivos intactas.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
Copy-Item "C:\MyRemoteData\scripts" -Destination "D:\MyLocalData\" -FromSession $Session
Exemplo 11: Copie recursivamente todo o conteúdo de uma pasta remota para o computador local
Uma sessão é criada no computador remoto chamado Server01 com a credencial de Contoso\User01 e armazena os resultados na variável chamada $Session.
O cmdlet Copy-Item copia todo o conteúdo da pasta C:\MyRemoteData\scripts remota para a pasta D:\MyLocalData\scripts local usando as informações de sessão armazenadas na variável $Session. Como o parâmetro Recurse é usado, a operação cria a pasta de scripts se ela ainda não existir. Se a pasta scripts tiver arquivos em subpastas, essas subpastas serão copiadas com suas árvores de arquivos intactas.
$Session = New-PSSession -ComputerName "Server01" -Credential "Contoso\User01"
$copyParams = @{
Path = "C:\MyRemoteData\scripts"
Destination = "D:\MyLocalData\scripts"
FromSession = $Session
Recurse = $true
}
Copy-Item @copyParams
Exemplo 12: Copiar recursivamente arquivos de uma árvore de pastas para a pasta atual
Este exemplo mostra como copiar arquivos de uma estrutura de pastas de vários níveis para uma única pasta plana.
Os três primeiros comandos mostram a estrutura de pastas existente e o conteúdo de dois arquivos, ambos os nomes file3.txt.
PS C:\temp\test> (Get-ChildItem C:\temp\tree -Recurse).FullName
C:\temp\tree\subfolder
C:\temp\tree\file1.txt
C:\temp\tree\file2.txt
C:\temp\tree\file3.txt
C:\temp\tree\subfolder\file3.txt
C:\temp\tree\subfolder\file4.txt
C:\temp\tree\subfolder\file5.txt
PS C:\temp\test> Get-Content C:\temp\tree\file3.txt
This is file3.txt in the root folder
PS C:\temp\test> Get-Content C:\temp\tree\subfolder\file3.txt
This is file3.txt in the subfolder
PS C:\temp\test> Copy-Item -Path C:\temp\tree -Filter *.txt -Recurse -Container:$false
PS C:\temp\test> (Get-ChildItem . -Recurse).FullName
C:\temp\test\subfolder
C:\temp\test\file1.txt
C:\temp\test\file2.txt
C:\temp\test\file3.txt
C:\temp\test\file4.txt
C:\temp\test\file5.txt
PS C:\temp\test> Get-Content .\file3.txt
This is file3.txt in the subfolder
O cmdlet Copy-Item tem o parâmetro Container definido como $false. Isso faz com que o conteúdo da pasta de origem seja copiado, mas não preserva a estrutura da pasta. Observe que os arquivos com o mesmo nome são substituídos na pasta de destino.
Exemplo 13: Usando filtros para copiar itens sem recursão
Este exemplo mostra os resultados usando o parâmetro Include para selecionar os itens a serem copiados.
Este exemplo usa a seguinte estrutura de pastas que contém os arquivos a serem copiados:
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
Neste exemplo, Copy-Item é chamado com um curinga para os parâmetros Path e Include. A especificação de um curinga para o parâmetro Path garante que ele processe todos os arquivos e pastas que correspondam D:\temp\tree\*. O parâmetro Include filtra a lista de itens a serem processados, limitando a operação apenas aos caminhos que começam com ex.
PS D:\temp\test\out> Copy-Item -Path D:\temp\tree\* -Include ex*
PS D:\temp\test\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt
O parâmetro Include é aplicado ao conteúdo de D:\temp\tree pasta para copiar todos os itens que correspondem ex*. Observe que, sem recursão, a pasta D:\temp\out\examples é copiada, mas nenhum de seu conteúdo é copiado.
Exemplo 14: Usando filtros para copiar itens com recursão
Este exemplo mostra os resultados usando o parâmetro Include para selecionar os itens a serem copiados.
Este exemplo usa a seguinte estrutura de pastas que contém os arquivos a serem copiados:
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
Neste exemplo, Copy-Item é chamado com um curinga para os parâmetros Path e Include. Especificar um curinga para o parâmetro Path garante que ele processe todos os arquivos e pastas que correspondem D:\temp\tree\*. O parâmetro Include filtra a lista de itens a serem processados, limitando a operação apenas aos caminhos que começam com ex.
D:\temp\out> Copy-Item -Path D:\temp\tree\* -Include ex* -Recurse
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example.ps1
D:\temp\out\example.txt
D:\temp\out\examples\subfolder
D:\temp\out\examples\example_1.txt
D:\temp\out\examples\example_2.txt
D:\temp\out\examples\subfolder\test.txt
O parâmetro Include é aplicado ao conteúdo de D:\temp\tree pasta para copiar todos os itens que correspondem ex*. Observe que, com a recursão, a pasta D:\temp\out\examples é copiada junto com todos os arquivos e subpastas. A cópia inclui arquivos que não correspondem ao filtro de inclusão. Ao usar Copy-Item, os filtros só se aplicam ao nível superior especificado pelo parâmetro Path. Em seguida, a recursão é aplicada a esses itens correspondentes.
Observação
O comportamento do parâmetro Exclude é o mesmo descrito neste exemplo, exceto que ele limita a operação apenas aos caminhos que não correspondem ao padrão.
Exemplo 15: Limitar os arquivos para copiar recursivamente de um caminho especificado por curinga
Este exemplo mostra como limitar os arquivos copiados recursivamente de um caminho de correspondência curinga para outra pasta. O Exemplo 13 mostra que, como o parâmetro Include filtra apenas os caminhos resolvidos para um Path dede especificação de curinga, o parâmetro Include não pode ser usado para limitar os arquivos copiados recursivamente de uma pasta. Em vez disso, você pode usar Get-ChildItem para localizar os itens que deseja copiar e passar esses itens para Copy-Item.
Este exemplo usa a seguinte estrutura de pastas que contém os arquivos a serem copiados:
D:\temp\tree\example.ps1D:\temp\tree\example.txtD:\temp\tree\examples\D:\temp\tree\examples\example_1.txtD:\temp\tree\examples\example_2.txtD:\temp\tree\examples\subfolder\D:\temp\tree\examples\subfolder\test.txt
Para copiar todos os itens que começam com ex*, use Get-ChildItem com os parâmetros Recurse e Filter e canalize os resultados para Copy-Item.
D:\temp\out> Get-ChildItem -Path D:\temp\tree -Recurse -Filter ex* | Copy-Item
D:\temp\out> (Get-ChildItem -Recurse).FullName
D:\temp\out\examples
D:\temp\out\example_1.txt
D:\temp\out\example_2.txt
D:\temp\out\example.ps1
D:\temp\out\example.txt
Ao contrário do Copy-Item, o parâmetro Filter para Get-ChildItem aplica-se aos itens descobertos durante a recursão. Isso permite que você localize, filtre e copie itens recursivamente.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Container
Indica que esse cmdlet preserva objetos de contêiner durante a operação de cópia. Por padrão, o parâmetro Container é definido como True.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | True |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Credential
Observação
Esse parâmetro não é suportado por nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | Current user |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Destination
Especifica o caminho para o novo local. O padrão é o diretório atual.
Para renomear o item que está sendo copiado, especifique um novo nome no valor do parâmetro Destination.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | Current directory |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Exclude
Especifica um ou mais elementos ou padrões de caminho, como "*.txt", para limitar a operação desse cmdlet. O valor desse parâmetro filtra em relação ao resultado de correspondência curinga do parâmetro Path, não aos resultados finais. Esse parâmetro só é efetivo quando o Caminho do é especificado com um ou mais curingas. Como esse parâmetro filtra apenas os caminhos resolvidos para o parâmetro Path, ele não filtra nenhum item descoberto ao recursar por pastas filhas com o parâmetro Recurse.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Filter
Especifica um filtro para qualificar o parâmetro Path. O provedor FileSystem é o único provedor do PowerShell instalado que oferece suporte ao uso de filtros. A sintaxe da linguagem de filtro do FileSystem pode ser encontrada em about_Wildcards. Os filtros são mais eficientes do que outros parâmetros, porque 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Indica que esse cmdlet copia itens que não podem ser alterados de outra forma, como copiar sobre um arquivo somente leitura ou alias.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-FromSession
Este é um parâmetro dinâmico disponibilizado pelo provedor FileSystem.
Especifique o objeto PSSession do qual um arquivo remoto está sendo copiado. Quando você usa esse parâmetro, os parâmetros Path e LiteralPath referem-se ao caminho local na máquina remota.
Para obter mais informações, consulte about_FileSystem_Provider.
Propriedades dos parâmetros
| Tipo: | PSSession |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Include
Especifica um ou mais elementos ou padrões de caminho, como "*.txt", para limitar a operação desse cmdlet. O valor desse parâmetro filtra em relação ao resultado de correspondência curinga do parâmetro Path, não aos resultados finais. Esse parâmetro só é efetivo quando o Caminho do é especificado com um ou mais curingas. Como esse parâmetro filtra apenas os caminhos resolvidos para o parâmetro Path, ele não filtra nenhum item descoberto ao recursar por pastas filhas com o parâmetro Recurse.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-LiteralPath
Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.
Para obter mais informações, consulte about_Quoting_Rules.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath, LP |
Conjuntos de parâmetros
LiteralPath
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-PassThru
Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Path
Especifica, como uma matriz de cadeia de caracteres, o caminho para os itens a serem copiados. Caracteres coringa são permitidos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
Path
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Recurse
Indica que esse cmdlet faz uma cópia recursiva.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ToSession
Este é um parâmetro dinâmico disponibilizado pelo provedor FileSystem.
Especifique o objeto PSSession para o qual um arquivo remoto está sendo copiado. Quando você usa esse parâmetro, o parâmetro Destination refere-se ao caminho local na máquina remota.
Para obter mais informações, consulte about_FileSystem_Provider.
Propriedades dos parâmetros
| Tipo: | PSSession |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
Você pode encaminhar uma cadeia de caracteres que contenha um caminho para este cmdlet.
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
PSObject
Quando você usa o parâmetro PassThru, esse cmdlet retorna um objeto que representa o item copiado.
Notas
O PowerShell inclui os seguintes aliases para Copy-Item:
- Todas as plataformas:
copycpi
- Windows:
cp
Este 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 obter mais informações, consulte about_Providers.
