Compartir a través de

Remove-SCLibraryServer

  • Referencia
Módulo:
VirtualMachineManager

Quita un servidor de biblioteca de VMM.

Syntax

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). Los objetos de biblioteca con un archivo correspondiente (como los archivos .vhd o .vmdk) almacenado en el sistema de archivos del servidor no se quitan del sistema de archivos mediante este cmdlet.

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 servidor de biblioteca.

  • Si este equipo es un servidor de biblioteca y un host, este cmdlet quita solo la característica de 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 las 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 el cmdlet Remove-SCLibraryServer se usa 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 las 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: Eliminación de 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 siguientes comandos usan $Credential para pasar sus 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 forEach de Windows PowerShell, escriba Get-Help about_ForEach.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 PSCredential , escriba Get-Help Get-Credential.

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

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-LibraryServer

Especifica un 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 el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.

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

-RunAsynchronously

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

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

-WhatIf

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

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