Remove-SCLibraryServer

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

Polecenie cmdlet Remove-SCLibraryServer usuwa obiekt serwera biblioteki (i wszystkie obiekty biblioteki na tym serwerze biblioteki) z bazy danych programu Virtual Machine Manager (VMM). Obiekty biblioteki, które mają odpowiadający im plik (taki jak pliki vhd lub vmdk) przechowywane w systemie plików serwera, nie są usuwane z systemu plików przez to polecenie cmdlet.

To polecenie cmdlet działa w następujący sposób:

• Jeśli ten serwer biblioteki jest również serwerem programu VMM, nie można usunąć serwera biblioteki, więc operacja usuwania serwera biblioteki zakończy się niepowodzeniem.

• Jeśli ten komputer jest zarówno serwerem biblioteki, jak i hostem, to polecenie cmdlet usuwa z programu VMM tylko funkcję serwera biblioteki, ale komputer nadal działa jako host.

• Jeśli ten komputer jest tylko serwerem biblioteki (a nie hostem ani serwerem programu VMM), serwer biblioteki jest usuwany z programu VMM.

To polecenie cmdlet zwraca obiekt w przypadku powodzenia (z właściwością MarkedForDeletion ustawioną na $True) lub zwraca komunikat o błędzie w przypadku niepowodzenia.

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

Pierwsze polecenie monituje o podanie poświadczeń. Po wyświetleniu okna dialogowego wpisz nazwę użytkownika i hasło dla konta administratora lokalnego lub konta domeny z uprawnieniami administratora na serwerze biblioteki.

Drugie polecenie pobiera obiekt serwera biblioteki o nazwie LibraryServer01 w programie VMMServer01 i zapisuje go w zmiennej $LibServ.

Trzecie polecenie usuwa obiekt serwera biblioteki i wszystkie udziały biblioteczne na tym serwerze z biblioteki programu VMM. Gdy polecenie cmdlet Remove-SCLibraryServer jest używane z parametrem LibraryServer , jak pokazano w tym przykładzie, do polecenia cmdlet można przekazać tylko jeden obiekt serwera biblioteki.

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

Pierwsze polecenie monituje o podanie poświadczeń. Po wyświetleniu okna dialogowego wpisz nazwę użytkownika i hasło dla konta administratora lokalnego lub konta domeny z uprawnieniami administratora na serwerze biblioteki.

Drugie polecenie pobiera wszystkie obiekty serwera biblioteki z programu VMMServer01 o nazwach zawierających ciąg "LibraryServer" i przechowuje zwrócone obiekty w zmiennej $LibServers (tablicy obiektów).

Trzecie polecenie przekazuje każdy obiekt serwera biblioteki w $LibServers do Remove-SCLibraryServer, który usuwa każdy obiekt z programu VMM.

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}

Pierwsze polecenie używa polecenia Get-Credential , aby wyświetlić monit o podanie nazwy użytkownika i hasła oraz przechowywać poświadczenia w $Credential. Poświadczenia wymagane do wykonania tej operacji to konto administratora lokalnego lub konto domeny z uprawnieniami administratora na serwerze biblioteki. Poniższe polecenia używają $Credential do przekazywania poświadczeń do każdego polecenia cmdlet, które wymaga poświadczeń.

Drugie polecenie używa polecenia cmdlet Find-SCCluster w celu potwierdzenia, że HAFileServer01 jest serwerem plików o wysokiej dostępności i przechowuje obiekt klastra w zmiennej $Cluster.

Trzecie polecenie usuwa serwer plików o wysokiej dostępności (określając jego nazwę) jako serwer biblioteki z programu VMM. Polecenie używa parametru RunAsynchronously w celu natychmiastowego zwrócenia kontroli do powłoki (przed zakończeniem tego polecenia), ponieważ ostatnie polecenie nie musi czekać, aż zakończy się to polecenie.

Ostatnie polecenie używa pętli ForEach w celu przekazania każdego obiektu przechowywanego w $Cluster.ClusterNodes do polecenia cmdlet Remove-SCLibraryServer , które usuwa każdy węzeł z programu VMM. Polecenie używa parametru RunAsynchronously w celu natychmiastowego zwrócenia kontroli do powłoki. Aby uzyskać więcej informacji o serwerach bibliotek, wpisz Get-Help Add-LibraryServer -Detailed. Aby uzyskać więcej informacji na temat instrukcji pętli ForEach programu Windows PowerShell, wpisz Get-Help about_ForEach.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.