Compartir a través de

Remove-SCLibraryServer

  • Referencia
Módulo:
VirtualMachineManager

Quita un servidor de biblioteca de VMM.

Sintaxis

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

Description

El cmdlet Remove-SCLibraryServer quita un objeto de servidor de biblioteca (y todos los objetos de biblioteca de ese servidor de biblioteca) de la base de datos de Virtual Machine Manager (VMM). Este cmdlet no quita los objetos de biblioteca que tienen un archivo correspondiente (como archivos .vhd o .vmdk) almacenados en el sistema de archivos del servidor.

Este cmdlet funciona de la siguiente manera:

  • Si este servidor de biblioteca también es el servidor VMM, no puede quitar el servidor de biblioteca, por lo que se producirá un error en la operación quitar el servidor de biblioteca.

  • Si este equipo es un servidor de biblioteca y un host, este cmdlet quita solo la característica del servidor de biblioteca de VMM, pero el equipo sigue funcionando como host.

  • Si este equipo es solo un servidor de biblioteca (no también un host o un servidor VMM), el servidor de biblioteca se quita de VMM.

Este cmdlet devuelve el objeto cuando se ejecuta correctamente (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Quitar un objeto de servidor de biblioteca de 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

El primer comando le pide credenciales. Cuando aparezca el cuadro de diálogo, escriba el nombre de usuario y la contraseña de una cuenta de administrador local o una cuenta de dominio con derechos de administrador en el servidor de biblioteca.

El segundo comando recupera el objeto de servidor de biblioteca denominado LibraryServer01 en VMMServer01 y lo almacena en la variable $LibServ.

El tercer comando quita el objeto de servidor de biblioteca y todos los recursos compartidos de biblioteca de este servidor, de la biblioteca VMM. Cuando se usa el cmdlet Remove-SCLibraryServer de con el parámetro LibraryServer como se muestra en este ejemplo, solo puede pasar un objeto de servidor de biblioteca al cmdlet .

Ejemplo 2: Quitar varios objetos de servidor de biblioteca que tienen una cadena específica en su nombre

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

El primer comando le pide credenciales. Cuando aparezca el cuadro de diálogo, escriba el nombre de usuario y la contraseña de una cuenta de administrador local o una cuenta de dominio con derechos de administrador en el servidor de biblioteca.

El segundo comando obtiene todos los objetos de servidor de biblioteca de VMMServer01 con nombres que incluyen la cadena "LibraryServer" y almacena los objetos devueltos en la variable $LibServers (una matriz de objetos).

El tercer comando pasa cada objeto de servidor de biblioteca de $LibServers a Remove-SCLibraryServer, que quita cada objeto de VMM.

Ejemplo 3: Quitar un servidor de biblioteca de alta disponibilidad y todos sus nodos

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}

El primer comando usa Get-Credential para solicitarle que proporcione un nombre de usuario y una contraseña y almacene sus credenciales en $Credential. Las credenciales necesarias para esta operación son una cuenta de administrador local o una cuenta de dominio con derechos de administrador en el servidor de biblioteca. Los comandos siguientes usan $Credential para pasar las credenciales a cada cmdlet que requiera credenciales.

El segundo comando usa el cmdlet Find-SCCluster para confirmar que HAFileServer01 es un servidor de archivos de alta disponibilidad y almacena el objeto de clúster en la variable $Cluster.

El tercer comando quita el servidor de archivos de alta disponibilidad (especificando su nombre) como servidor de biblioteca de VMM. El comando usa el parámetro RunAsynchronously para devolver el control al shell inmediatamente (antes de que se complete este comando) porque el último comando no necesita esperar hasta que finalice este comando.

El último comando usa un bucle forEach para pasar cada objeto almacenado en $Cluster.ClusterNodes al cmdlet Remove-SCLibraryServer, que quita cada nodo de VMM. El comando usa el parámetro RunAsynchronously para devolver el control al shell inmediatamente. Para obtener más información sobre los servidores de biblioteca, escriba Get-Help Add-LibraryServer -Detailed. Para obtener más información sobre la instrucción de bucle de ForEach de Windows PowerShell , escriba .

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica un objeto de credencial o, para algunos cmdlets, un objeto de cuenta de ejecución que contiene el nombre de usuario y la contraseña de una cuenta que tiene permiso para realizar esta acción. O bien, en el caso de Restart-SCJob, tiene permiso para completar una tarea reiniciada.

Para obtener más información sobre el objeto de PSCredential, escriba Get-Help Get-Credential.

Para obtener más información sobre las cuentas de ejecución, escriba Get-Help New-SCRunAsAccount.

Tipo:VMMCredential
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LibraryServer

Especifica un objeto de servidor de biblioteca VMM.

Tipo:LibraryServer
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False