Partilhar via

Remove-SCLibraryServer

  • Referência
Módulo:
VirtualMachineManager

Remove um servidor de biblioteca do VMM.

Syntax

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 VMM (Virtual Machine Manager). 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 funciona da seguinte maneira:

  • Se esse servidor de biblioteca também for o servidor do VMM, você não poderá remover o servidor de biblioteca, portanto, a operação remover 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á funcionando 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.

Esse cmdlet retorna o objeto após o sucesso (com a propriedade MarkedForDeletion definida como $True) ou retorna uma mensagem de erro após a 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 para uma conta de administrador local ou uma conta de domínio com direitos de administrador no servidor de biblioteca.

O segundo comando recupera o objeto de 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 têm 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 para uma conta de administrador local ou uma conta de domínio com direitos de administrador no servidor de biblioteca.

O segundo comando obtém todos os objetos de 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 objeto).

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 armazene 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 aguardar 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 loop Windows PowerShell ForEach, digiteGet-Help about_ForEach.

Parâmetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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:VMMCredential
Position:Named
Default value:None
Required:True
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

-LibraryServer

Especifica um objeto de servidor de biblioteca do VMM.

Type:LibraryServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False