Partilhar via

Remove-SCLibraryServer

  • Referência
Módulo:
VirtualMachineManager

Remove um servidor de biblioteca do VMM.

Sintaxe

Remove-SCLibraryServer
      [-LibraryServer] <LibraryServer>
      -Credential <VMMCredential>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-SCLibraryServer remove um objeto de servidor de biblioteca (e todos os objetos de biblioteca nesse servidor de biblioteca) do banco de dados do Virtual Machine Manager (VMM). Os objetos de biblioteca que têm um arquivo correspondente (como arquivos .vhd ou .vmdk) armazenados no sistema de arquivos do servidor não são removidos do sistema de arquivos por este cmdlet.

Este cmdlet opera da seguinte maneira:

  • Se esse servidor de biblioteca também for o servidor VMM, não será possível remover o servidor de biblioteca, portanto, a operação de remoção do servidor de biblioteca falhará.

  • Se este computador for um servidor de biblioteca e um host, esse cmdlet removerá apenas o recurso de servidor de biblioteca do VMM, mas o computador continuará a funcionar como um host.

  • Se este computador for apenas um servidor de biblioteca (não também um host ou um servidor VMM), o servidor de biblioteca será removido do VMM.

Este cmdlet retorna o objeto após o êxito (com a propriedade MarkedForDeletion definida como $True) ou retorna uma mensagem de erro em caso de falha.

Exemplos

Exemplo 1: Remover um objeto de servidor de biblioteca do VMM

PS C:\> $Creds = Get-Credential
PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer1.Contoso.com" -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Remove-SCLibraryServer -LibraryServer $LibServ -Credential $Creds

O primeiro comando solicita credenciais. Quando a caixa de diálogo for exibida, digite o nome de usuário e a senha de uma conta de Administrador local ou de uma conta de domínio com direitos de administrador no servidor de biblioteca.

O segundo comando recupera o objeto do servidor de biblioteca chamado LibraryServer01 no VMMServer01 e o armazena na variável $LibServ.

O terceiro comando remove o objeto do servidor de biblioteca e todos os compartilhamentos de biblioteca neste servidor da biblioteca do VMM. Quando o cmdlet Remove-SCLibraryServer é usado com o parâmetro LibraryServer, conforme mostrado neste exemplo, você pode passar apenas um objeto de servidor de biblioteca para o cmdlet.

Exemplo 2: Remover vários objetos de servidor de biblioteca que tenham uma cadeia de caracteres específica em seu nome

PS C:\> $Creds = Get-Credential
PS C:\> $LibServers = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "LibraryServer" }
PS C:\> $LibServers | Remove-SCLibraryServer -Credential $Creds

O primeiro comando solicita credenciais. Quando a caixa de diálogo for exibida, digite o nome de usuário e a senha de uma conta de Administrador local ou de uma conta de domínio com direitos de administrador no servidor de biblioteca.

O segundo comando obtém todos os objetos do servidor de biblioteca do VMMServer01 com nomes que incluem a cadeia de caracteres "LibraryServer" e armazena os objetos retornados na variável $LibServers (uma matriz de objetos).

O terceiro comando passa cada objeto de servidor de biblioteca em $LibServers para Remove-SCLibraryServer, que remove cada objeto do VMM.

Exemplo 3: Remover um servidor de biblioteca altamente disponível e todos os seus nós

PS C:\> $Credential = Get-Credential
PS C:\> $Cluster = Find-SCCluster -ComputerName "HAFileServer01.Contoso.com" -Credential $Credential
PS C:\> Remove-LibraryServer -LibraryServer "HAFileServer01.Contoso.com" -Credential $Credential -RunAsynchronously
PS C:\> ForEach ($Node in $Cluster.ClusterNodes) {Remove-LibraryServer -LibraryServer $Node -Credential $Credential -RunAsynchronously}

O primeiro comando usa Get-Credential para solicitar que você forneça um nome de usuário e senha e armazena suas credenciais em $Credential. As credenciais necessárias para esta operação são uma conta de Administrador local ou uma conta de domínio com direitos de administrador no servidor de biblioteca. Os comandos a seguir usam $Credential para passar suas credenciais para cada cmdlet que requer credenciais.

O segundo comando usa o cmdlet Find-SCCluster para confirmar que HAFileServer01 é um servidor de arquivos altamente disponível e armazena o objeto de cluster na variável $Cluster.

O terceiro comando remove o servidor de arquivos altamente disponível (especificando seu nome) como um servidor de biblioteca do VMM. O comando usa o parâmetro RunAsynchronously para retornar o controle ao shell imediatamente (antes que este comando seja concluído) porque o último comando não precisa esperar até que esse comando seja concluído.

O último comando usa um loop de ForEach para passar cada objeto armazenado em $Cluster.ClusterNodes para o cmdlet Remove-SCLibraryServer, que remove cada nó do VMM. O comando usa o parâmetro RunAsynchronously para retornar o controle ao shell imediatamente. Para obter mais informações sobre servidores de biblioteca, digite Get-Help Add-LibraryServer -Detailed. Para obter mais informações sobre a instrução de loop do Windows PowerShell ForEach, digite Get-Help about_ForEach.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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:VMMCredential
Position:Named
Default value:None
Necessário:True
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

-LibraryServer

Especifica um objeto de servidor de biblioteca do VMM.

Tipo:LibraryServer
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
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

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False