Udostępnij za pośrednictwem

Remove-SCLibraryServer

  • Odwołanie
Moduł:
VirtualMachineManager

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