Condividi tramite

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). Gli oggetti di libreria con un file corrispondente (ad esempio file con estensione vhd o vmdk) archiviati nel file system del server non vengono rimossi dal file system da questo cmdlet.

Questo cmdlet funziona come segue:

  • Se questo server di libreria è anche il server VMM, non è possibile rimuovere il server di libreria, quindi 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 il 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 in caso di esito positivo (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 nel server di libreria. I comandi seguenti usano $Credential per passare le credenziali a ogni cmdlet che richiede le 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 di 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 ForEach di Windows PowerShell , digitare .

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 .

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

Tipo:VMMCredential
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LibraryServer

Specifica un oggetto server di libreria VMM.

Tipo:LibraryServer
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False