Compartilhar via

Remove-SCLibraryShare

  • Referência
Módulo:
VirtualMachineManager

Remove um compartilhamento de biblioteca do VMM, mas não exclui o compartilhamento do sistema de arquivos do Windows.

Sintaxe

Remove-SCLibraryShare
      [-LibraryShare] <LibraryShare>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCLibraryShare remove um compartilhamento de biblioteca da biblioteca do VMM (Virtual Machine Manager). Esse cmdlet não remove nenhum compartilhamento ou arquivos do sistema de arquivos no computador.

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como $True) ou retorna uma mensagem de erro após falha.

Exemplos

Exemplo 1: remover um objeto de compartilhamento de biblioteca da biblioteca do VMM

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Remove-SCLibraryShare -LibraryShare $LibShare

O primeiro comando obtém o objeto de compartilhamento de biblioteca chamado AllVHDs em LibraryServer01 da biblioteca do VMM no VMMServer01 e armazena o objeto na variável $LibShare.

O segundo comando remove o objeto de compartilhamento de biblioteca e todos os objetos de biblioteca nesse compartilhamento da biblioteca do VMM, mas não exclui o compartilhamento ou seu conteúdo do sistema de arquivos no servidor de biblioteca.

Exemplo 2: remover vários objetos de compartilhamento de biblioteca da biblioteca do VMM

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Remove-SCLibraryShare

O primeiro comando obtém todos os objetos de compartilhamento de biblioteca em LibraryServer01 cujo nome inclui a cadeia de caracteres "vhd" da biblioteca do VMM no VMMServer01 e armazena esses objetos de compartilhamento na variável $LibShares (uma matriz de objetos).

O segundo comando passa cada objeto de compartilhamento de biblioteca em $LibShares para Remove-SCLibraryShare. O cmdlet remove cada um dos objetos de compartilhamento de biblioteca e todos os objetos no compartilhamento da biblioteca do VMM, mas não exclui os compartilhamentos correspondentes ou seu conteúdo do sistema de arquivos no servidor de biblioteca.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
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

-LibraryShare

Especifica um objeto de compartilhamento de biblioteca do VMM.

Tipo:LibraryShare
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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