Partilhar via

Get-SCDirectoryChildItem

  • Referência
Módulo:
VirtualMachineManager

Obtém todos os arquivos e subdiretórios no diretório especificado em um host de máquina virtual ou em um servidor de biblioteca gerenciado pelo VMM.

Sintaxe

Get-SCDirectoryChildItem
   -VMHost <Host>
   -Path <String>
   [<CommonParameters>]
Get-SCDirectoryChildItem
   -LibraryServer <LibraryServer>
   -Path <String>
   [<CommonParameters>]

Description

O cmdlet Get-SCDirectoryChildItem do obtém todos os arquivos e subdiretórios imediatamente sob o diretório especificado em um host de máquina virtual ou em um servidor de biblioteca gerenciado pelo Virtual Machine Manager (VMM). Se você especificar um caminho de compartilhamento (como \ServerName\ShareName\Directory\FileName), os subdiretórios do caminho de compartilhamento serão retornados.

Se você usar o cmdlet Get-SCDirectoryChildItem para recuperar arquivos e subdiretórios em um servidor de biblioteca, deverá especificar um caminho para um compartilhamento de biblioteca válido. Por exemplo, o caminho de compartilhamento para o compartilhamento de biblioteca padrão instalado pela Instalação quando você instala o VMM pela primeira vez é: \VMMServerName.DomainName.com\MSSCVMMLibrary

Exemplos

Exemplo 1: Obter os arquivos e subdiretórios para o caminho especificado em um host VMM

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Get-SCDirectoryChildItem -VMHost $VMHost -Path "C:\"

O primeiro comando obtém o objeto host chamado VMHost01 do banco de dados do VMM e armazena o objeto na variável $VMHost.

O segundo comando exibe o nome e outras informações sobre cada arquivo e subdiretório imediatamente sob a unidade C:\ no VMHost01.

Exemplo 2: Obter os subdiretórios para o caminho especificado em um servidor de biblioteca

PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" -ComputerName "FileServer01.Contoso.com"
PS C:\> Get-SCDirectoryChildItem -LibraryServer $LibServ -Path "\\FileServer01.Contoso.com\MSSCVMMLibrary"

O primeiro comando obtém o objeto do servidor de biblioteca chamado FileServer01 do VMMServer01 e armazena o objeto na variável $LibServ.

O segundo comando exibe o nome, o diretório pai e outras informações sobre cada arquivo armazenado no diretório para o compartilhamento de biblioteca padrão no FileServer01. Você deve especificar o caminho completo para o compartilhamento de biblioteca.

Nota: Este exemplo pressupõe que o compartilhamento de biblioteca padrão do VMM (MSSCVMMLibrary) seja usado em seu ambiente. Para obter os nomes dos compartilhamentos de biblioteca, digite Get-SCLibraryShare | Select Name.

Parâmetros

-LibraryServer

Especifica um objeto de servidor de biblioteca do VMM.

Tipo:LibraryServer
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Path

Especifica o caminho de destino para a operação.

Exemplos de formatos:

  • Caminho local: -Path "F:\"
  • Caminho UNC: -Path "\\Library\Templates"
  • Caminho do GUID do volume: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Caminho VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Caminho do Citrix XenServer: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"

Este parâmetro aceita caracteres curinga para um caminho UNC.

Exemplo de formato:

Caminho UNC: -Path "\\VMHostServer\MyVMs\*VM*"

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMHost

Especifica um objeto de host de máquina virtual. O VMM suporta hosts Hyper-V, VMware ESX e Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost.

Tipo:Host
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

VMHostFileInformation

Este cmdlet retorna um VMHostFileInformation objeto.