Remove-SCLibraryServer
Usuwa serwer biblioteki z programu VMM.
Składnia
Remove-SCLibraryServer
[-LibraryServer] <LibraryServer>
-Credential <VMMCredential>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
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ą odpowiedni plik (np. 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 tylko funkcję serwera biblioteki z programu VMM, ale komputer nadal działa jako host.
Jeśli ten komputer jest tylko serwerem biblioteki (nie jest również hostem lub serwerem programu VMM), serwer biblioteki zostanie usunięty z programu VMM.
To polecenie cmdlet zwraca obiekt po pomyślnym powodzeniu (z właściwością MarkedForDeletion ustawioną na $True) lub zwraca komunikat o błędzie po awarii.
Przykłady
Przykład 1. Usuwanie obiektu serwera biblioteki z programu 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
Pierwsze polecenie wyświetla monit o poświadczenia. 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 na serwerze VMMServer01 i przechowuje go w zmiennej $LibServ.
Trzecie polecenie usuwa obiekt serwera biblioteki, a wszystkie udziały biblioteki na tym serwerze z biblioteki programu VMM. Gdy polecenie cmdlet Remove-SCLibraryServer jest używane z parametrem LibraryServer , jak pokazano w tym przykładzie, można przekazać tylko jeden obiekt serwera biblioteki do polecenia cmdlet.
Przykład 2. Usuwanie wielu obiektów serwera biblioteki, które mają określony ciąg w ich nazwie
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 wyświetla monit o poświadczenia. 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 VMMServer01 z nazwami, które zawierają ciąg "LibraryServer" i przechowuje zwrócone obiekty w zmiennej $LibServers (tablica obiektów).
Trzecie polecenie przekazuje każdy obiekt serwera biblioteki w $LibServers do remove-SCLibraryServer, który usuwa każdy obiekt z programu VMM.
Przykład 3. Usuwanie serwera biblioteki o wysokiej dostępności i wszystkich jego węzłów
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 przechowywanie poświadczeń w $Credential. Wymagane poświadczenia dla tej operacji to konto administratora lokalnego lub konto domeny z uprawnieniami administratora na serwerze biblioteki. Następujące polecenia używają $Credential, aby przekazać poświadczenia do każdego polecenia cmdlet wymagającego 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 do zwrócenia kontroli do powłoki bezpośrednio (przed ukończeniem tego polecenia), ponieważ ostatnie polecenie nie musi czekać do momentu zakończenia tego polecenia.
Ostatnie polecenie używa pętli ForEach do przekazywania 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 kontrolki do powłoki.
Aby uzyskać więcej informacji na temat serwerów biblioteki, wpisz Get-Help Add-LibraryServer -Detailed
.
Aby uzyskać więcej informacji na temat instrukcji pętli Windows PowerShell ForEach, wpisz Get-Help about_ForEach
.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Określa obiekt poświadczeń lub, dla niektórych poleceń cmdlet, obiekt konta Uruchom jako, który zawiera nazwę użytkownika i hasło konta, które ma uprawnienia do wykonania tej akcji. Lub w przypadku zadania Restart-SCJob ma uprawnienia do wykonania ponownie uruchomionego zadania.
Aby uzyskać więcej informacji na temat obiektu PSCredential , wpisz Get-Help Get-Credential
.
Aby uzyskać więcej informacji na temat kont Uruchom jako, wpisz Get-Help New-SCRunAsAccount
.
Type: | VMMCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LibraryServer
Określa obiekt serwera biblioteki programu VMM.
Type: | LibraryServer |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PROTipID
Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |