Remove-SCLibraryServer

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

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 VMM (Virtual Machine Manager). 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 esse cmdlet.

Esse cmdlet funciona da seguinte maneira:

• Se esse servidor de biblioteca também for o servidor VMM, você não poderá remover o servidor de biblioteca, portanto, a operação de remoção do servidor de biblioteca falhará.

• Se esse 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 esse 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.

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

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 nesse 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.

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.

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 essa 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 esse 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 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 ForEach do Windows PowerShell, digite Get-Help about_ForEach.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.