Share via

Remove-SCLibraryServer

  • Riferimento
Modulo:
VirtualMachineManager

Rimuove un server di libreria da VMM.

Sintassi

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

Descrizione

Il cmdlet Remove-SCLibraryServer rimuove un oggetto server di libreria (e tutti gli oggetti di libreria in tale server di libreria) dal database di Virtual Machine Manager (VMM). Questo cmdlet non rimuove dal file system gli oggetti libreria per cui è archiviato un file corrispondente nel file system del server, ad esempio un file con estensione vhd o vmdk.

Di seguito viene illustrato il funzionamento di questo cmdlet:

  • Se questo server di libreria è anche il server VMM, non è possibile rimuovere il server di libreria, pertanto l'operazione di rimozione del server di libreria avrà esito negativo.

  • Se questo computer è sia un server di libreria che un host, questo cmdlet rimuove solo la funzionalità del server di libreria da VMM, ma il computer continua a funzionare come host.

  • Se questo computer è solo un server di libreria (non anche un host o un server VMM), il server di libreria viene rimosso da VMM.

Questo cmdlet restituisce l'oggetto al completamento (con la proprietà MarkedForDeletion impostata su $True) o restituisce un messaggio di errore in caso di errore.

Esempio

Esempio 1: Rimuovere un oggetto server di libreria da 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

Il primo comando richiede le credenziali. Quando viene visualizzata la finestra di dialogo, digitare il nome utente e la password per un account amministratore locale o un account di dominio con diritti di amministratore nel server di libreria.

Il secondo comando recupera l'oggetto server di libreria denominato LibraryServer01 in VMMServer01 e lo archivia nella variabile $LibServ.

Il terzo comando rimuove l'oggetto server di libreria e tutte le condivisioni di libreria in questo server, dalla libreria VMM. Quando il cmdlet Remove-SCLibraryServer viene usato con il parametro LibraryServer , come illustrato in questo esempio, è possibile passare un solo oggetto server di libreria al cmdlet .

Esempio 2: Rimuovere più oggetti server di libreria con una stringa specifica nel 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

Il primo comando richiede le credenziali. Quando viene visualizzata la finestra di dialogo, digitare il nome utente e la password per un account amministratore locale o un account di dominio con diritti di amministratore nel server di libreria.

Il secondo comando ottiene tutti gli oggetti server di libreria da VMMServer01 con nomi che includono la stringa "LibraryServer" e archivia gli oggetti restituiti nella variabile $LibServers (matrice di oggetti).

Il terzo comando passa ogni oggetto server di libreria in $LibServers a Remove-SCLibraryServer, che rimuove ogni oggetto da VMM.

Esempio 3: Rimuovere un server di libreria a disponibilità elevata e tutti i relativi nodi

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}

Il primo comando usa Get-Credential per richiedere di specificare un nome utente e una password e archiviare le credenziali in $Credential. Le credenziali necessarie per questa operazione sono un account amministratore locale o un account di dominio con diritti di amministratore per il server di libreria. I comandi seguenti utilizzano $Credential per passare le credenziali dell'utente a ogni cmdlet che richiede credenziali.

Il secondo comando usa il cmdlet Find-SCCluster per verificare che HAFileServer01 sia un file server a disponibilità elevata e archivia l'oggetto cluster nella variabile $Cluster.

Il terzo comando rimuove il file server a disponibilità elevata (specificandone il nome) come server di libreria da VMM. Il comando usa il parametro RunAsynchronously per restituire il controllo alla shell immediatamente (prima del completamento di questo comando) perché l'ultimo comando non deve attendere fino al termine di questo comando.

L'ultimo comando usa un ciclo ForEach per passare ogni oggetto archiviato in $Cluster.ClusterNodes al cmdlet Remove-SCLibraryServer , che rimuove ogni nodo da VMM. Il comando usa il parametro RunAsynchronously per restituire immediatamente il controllo alla shell. Per altre informazioni sui server di libreria, digitare Get-Help Add-LibraryServer -Detailed. Per altre informazioni sull'istruzione ciclo Windows PowerShell ForEach, digitare Get-Help about_ForEach.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Credential

Specifica un oggetto credenziale o, per alcuni cmdlet, un oggetto account RunAs che contiene il nome utente e la password di un account che dispone dell'autorizzazione per eseguire questa azione. In alternativa, nel caso di Restart-SCJob, dispone dell'autorizzazione per completare un'attività riavviata.

Per altre informazioni sull'oggetto PSCredential , digitare Get-Help Get-Credential.

Per altre informazioni sugli account RunAs, digitare Get-Help New-SCRunAsAccount.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-LibraryServer

Specifica un oggetto server di libreria VMM.

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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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