Compartir a través de

Remove-SCLibraryShare

  • Referencia
Módulo:
VirtualMachineManager

Quita un recurso compartido de biblioteca de VMM, pero no elimina el recurso compartido del sistema de archivos de Windows.

Sintaxis

Remove-SCLibraryShare
      [-LibraryShare] <LibraryShare>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-SCLibraryShare quita un recurso compartido de biblioteca de la biblioteca de Virtual Machine Manager (VMM). Este cmdlet no quita ningún recurso compartido ni archivo del sistema de archivos del equipo.

Este cmdlet devuelve el objeto tras éxito (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Quitar un objeto de recurso compartido de biblioteca de la biblioteca VMM

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Remove-SCLibraryShare -LibraryShare $LibShare

El primer comando obtiene el objeto de recurso compartido de biblioteca denominado AllVHDs en LibraryServer01 de la biblioteca VMM en VMMServer01 y, a continuación, almacena el objeto en la variable $LibShare.

El segundo comando quita el objeto de recurso compartido de biblioteca y todos los objetos de biblioteca de este recurso compartido de la biblioteca VMM, pero no elimina el recurso compartido ni su contenido del sistema de archivos en el servidor de biblioteca.

Ejemplo 2: Quitar varios objetos de recurso compartido de biblioteca de la biblioteca VMM

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Remove-SCLibraryShare

El primer comando obtiene todos los objetos compartidos de biblioteca en LibraryServer01 cuyo nombre incluye la cadena "vhd" de la biblioteca VMM en VMMServer01 y, a continuación, almacena estos objetos compartidos en la variable $LibShares (una matriz de objetos).

El segundo comando pasa cada objeto compartido de biblioteca en $LibShares a Remove-SCLibraryShare. El cmdlet quita cada uno de los objetos compartidos de biblioteca y todos los objetos del recurso compartido de la biblioteca VMM, pero no elimina los recursos compartidos correspondientes ni su contenido del sistema de archivos en el servidor de biblioteca.

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

-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

-LibraryShare

Especifica un objeto compartido de biblioteca VMM.

Tipo:LibraryShare
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