Add-SCLibraryShare
Adiciona compartilhamentos do Windows no sistema de arquivos de um servidor de biblioteca à biblioteca do VMM como compartilhamentos de biblioteca.
Syntax
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, você deve primeiro 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 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 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), discos de disquete virtual (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á seja 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á seja 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 padrão Windows PowerShell ForEach, digiteGet-Help about_ForEach.
A instrução loop ForEach 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifica uma descrição para o compartilhamento de biblioteca.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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"
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseAlternateDataStream
Especifica se o uso de AlternateDataStream deve ou não ser usado.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
LibraryShare
Este cmdlet retorna um objeto LibraryShare .