Add-SCLibraryShare
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 Virtual Machine Manager (VMM) como compartilhamentos de biblioteca.
Antes de adicionar um compartilhamento de biblioteca à biblioteca do VMM, você deve primeiro criar o compartilhamento no sistema de arquivos do Windows. Pode, por exemplo, utilizar o Explorador do Windows para criar e partilhar uma pasta que pretende adicionar à biblioteca.
Se você criar um compartilhamento do Windows no mesmo nível do compartilhamento de biblioteca padrão (MSSCVMMLibrary) 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 verificará 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.
Nota: Os recursos da biblioteca que podem ser descobertos apenas pela atualização da biblioteca, mas não criados por um administrador, incluem discos rígidos virtuais (arquivos .vhd baseados no Windows, arquivos .vhd baseados no 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 no $SharePaths para o cmdlet Add-SCLibraryShare, que adiciona cada compartilhamento do Windows como um compartilhamento de biblioteca ao VMM.
Nota: Para obter mais informações sobre a instrução de loop padrão do Windows PowerShell ForEach, digite Get-Help about_ForEach.
A instrução ForEach loop não é a mesma que o 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Credential
Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Run As 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 Run As, digite Get-Help New-SCRunAsAccount.
| Tipo: | PSCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Description
Especifica uma descrição para o compartilhamento de biblioteca.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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 de Nomenclatura Universal).
Exemplo de formato: -SharePath "\\LibServer01\LibShare"
| Tipo: | String |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-UseAlternateDataStream
Especifica se deve ou não usar o Use AlternateDataStream.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM.
| Tipo: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
Saídas
LibraryShare
Este cmdlet retorna um objeto LibraryShare