Compartilhar via

Add-SCLibraryShare

  • Referência
Módulo:
VirtualMachineManager

Adiciona compartilhamentos do Windows no sistema de arquivos de um servidor de biblioteca à biblioteca do VMM como compartilhamentos de biblioteca.

Sintaxe

Add-SCLibraryShare
   [-VMMServer <ServerConnection>]
   [-SharePath] <String>
   [-Credential <PSCredential>]
   [-Description <String>]
   [-AddDefaultResources]
   [-JobGroup <Guid>]
   [-UseAlternateDataStream <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Add-SCLibraryShare adiciona compartilhamentos do Windows no sistema de arquivos de um servidor de biblioteca à biblioteca do VMM (Virtual Machine Manager) como compartilhamentos de biblioteca.

Antes de adicionar um compartilhamento de biblioteca à biblioteca do VMM, primeiro você deve criar o compartilhamento no sistema de arquivos do Windows. Você pode, por exemplo, usar o Windows Explorer para criar e compartilhar uma pasta que deseja adicionar à biblioteca.

Se você criar um compartilhamento do Windows no mesmo nível que o MSSCVMMLibrary (compartilhamento de biblioteca padrão) criado pela Instalação do VMM ou em um servidor de biblioteca separado, use o cmdlet Add-SCLibraryShare para adicionar esse compartilhamento à biblioteca do VMM.

Se você criar uma pasta do Windows no compartilhamento de biblioteca padrão do VMM (MSSCVMMLibrary), o VMM examinará automaticamente o compartilhamento, descobrirá todos os objetos existentes armazenados nesse compartilhamento que se qualificam como objetos de biblioteca e adicionará os objetos de biblioteca à biblioteca. No entanto, você pode usar o cmdlet Read-SCLibraryShare para atualizar manualmente esse compartilhamento e importar seu conteúdo para a biblioteca do VMM.

Observação: os recursos de biblioteca que podem ser descobertos apenas pelo atualizador de biblioteca, mas não criados por um administrador, incluem discos rígidos virtuais (arquivos .vhd baseados no Windows, arquivos .vhd baseados em Citrix XenServer ou arquivos .vmdk baseados em VMware), disquetes virtuais (arquivos .vfd baseados no Windows ou arquivos .flp baseados em VMware), imagens ISO (arquivos .iso) e scripts.

Exemplos

Exemplo 1: Adicionar um compartilhamento do Windows como um objeto de compartilhamento de biblioteca à biblioteca do VMM

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Add-SCLibraryShare -SharePath "\\LibraryServer01\AllVHDs"

O primeiro comando se conecta ao VMMServer01.

O segundo comando adiciona um objeto de compartilhamento de biblioteca à biblioteca chamada AllVHDs (um compartilhamento do Windows localizado em LibraryServer01). Este exemplo pressupõe que LibraryServer01 já é um servidor de biblioteca do VMM.

Exemplo 2: Adicionar dois compartilhamentos do Windows como objetos de compartilhamento de biblioteca à biblioteca do VMM

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $SharePaths = "\\LibraryServer01\AllVHDs", "\\LibraryServer01\AllISOs"
PS C:\> ForEach($SharePath in $SharePaths) { Add-SCLibraryShare -SharePath $SharePath }

O primeiro comando se conecta ao VMMServer1.

O segundo comando armazena as cadeias de caracteres "\LibraryServer01\AllVHDs" e "\LibraryServer01\AllSOs" na variável $SharePaths. Este exemplo pressupõe que LibraryServer01 já é um servidor de biblioteca do VMM.

O último comando usa um loop ForEach para passar os dois nomes de compartilhamento armazenados em $SharePaths para o cmdlet Add-SCLibraryShare , que adiciona cada compartilhamento do Windows como um compartilhamento de biblioteca ao VMM.

Observação: para obter mais informações sobre a instrução de loop forEach do Windows PowerShell padrão, digite . A instrução de loop forEach não é igual ao cmdlet ForEach-Object, que usa ForEach como um alias.

Parâmetros

-AddDefaultResources

Indica que os recursos padrão para um compartilhamento de biblioteca são adicionados.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Executar como que contém o nome de usuário e a senha de uma conta que tem permissão para executar essa ação. Ou, no caso de Restart-SCJob, tem permissão para concluir uma tarefa reiniciada.

Para obter mais informações sobre o objeto PSCredential, digite Get-Help Get-Credential.

Para obter mais informações sobre contas Executar como, digite Get-Help New-SCRunAsAccount.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para o compartilhamento de biblioteca.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SharePath

Especifica um caminho para um compartilhamento de biblioteca válido em um servidor de biblioteca existente que usa um caminho UNC (Convenção Universal de Nomenclatura).

Formato de exemplo: -SharePath "\\LibServer01\LibShare"

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseAlternateDataStream

Especifica se o uso de AlternateDataStream deve ou não ser usado.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

LibraryShare

Esse cmdlet retorna um objeto LibraryShare.