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 do servidor da biblioteca (e todos os objetos da biblioteca no servidor da biblioteca) da base de dados Virtual Machine Manager (VMM). Os objetos da biblioteca que possuam um ficheiro correspondente (tais como ficheiros .vhd ou .vmdk) armazenados no sistema de ficheiros do servidor não são removidos do sistema de ficheiros por este cmdlet.

Este cmdlet funciona da seguinte forma:

  • Se este servidor de biblioteca também for o servidor VMM, não é possível remover o servidor da biblioteca, pelo que a operação do servidor da biblioteca remover falhará.

  • Se este computador for simultaneamente um servidor de biblioteca e um anfitrião, este cmdlet remove apenas a funcionalidade do servidor da biblioteca do VMM, mas o computador continua a funcionar como anfitrião.

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

Este cmdlet devolve o objeto após o sucesso (com a propriedade marcada para $True) ou devolve uma mensagem de erro após falha.

Exemplos

Exemplo 1: Remover um objeto do servidor da 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 pede-lhe credenciais. Quando a caixa de diálogo aparecer, digite o nome de utilizador e a palavra-passe para uma conta de Administrador local ou uma conta de domínio com direitos de administrador no servidor da biblioteca.

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

O terceiro comando remove o objeto do servidor da biblioteca, e todas as partilhas da biblioteca neste servidor, da biblioteca VMM. Quando o cmdlet Remove-SCLibraryServer for utilizado com o parâmetro LibraryServer , como mostrado neste exemplo, pode passar apenas um objeto do servidor da biblioteca para o cmdlet.

Exemplo 2: Remover vários objetos do servidor da biblioteca que têm uma cadeia 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 pede-lhe credenciais. Quando a caixa de diálogo aparecer, digite o nome de utilizador e a palavra-passe para uma conta de Administrador local ou uma conta de domínio com direitos de administrador no servidor da biblioteca.

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

O terceiro comando passa cada objeto do servidor da biblioteca em $LibServers para Remove-SCLibraryServer, que remove cada objeto de 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 utiliza o Get-Credential para lhe solicitar que forneça um nome de utilizador e senha e armazena as 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 da biblioteca. Os seguintes comandos usam $Credential para passar as suas credenciais a cada cmdlet que requer credenciais.

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

O terceiro comando remove o servidor de ficheiros altamente disponível (especificando o seu nome) como servidor de biblioteca do VMM. O comando utiliza o parâmetro RunAsynchronously para devolver o controlo à casca imediatamente (antes que este comando termine) porque o último comando não precisa de esperar até que este comando termine.

O último comando utiliza um laço ForEach para passar cada objeto armazenado em $Cluster.ClusterNodes para o cmdlet Remove-SCLibraryServer , que remove cada nó de VMM. O comando utiliza o parâmetro RunAsynchronously para retornar o controlo à casca imediatamente. Para mais informações sobre servidores de bibliotecas, escreva Get-Help Add-LibraryServer -Detailed. Para mais informações sobre a declaração de loop Windows PowerShell ForEach, escreva Get-Help about_ForEach.

Parâmetros

-Confirm

Solicita a 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 credencial ou, para alguns cmdlets, um objeto de conta Run As que contém o nome de utilizador e a palavra-passe de uma conta que tem permissão para realizar esta ação. Ou, no caso do Restart-SCJob, tem permissão para completar uma tarefa reiniciada.

Para mais informações sobre o objeto PSCredential, escrevaGet-Help Get-Credential.

Para mais informações sobre Run As accounts, escreva 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 progresso do trabalho é rastreado e armazenado na variável nomeada por este 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 VMM.

Type:LibraryServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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