Remove-SCService
Usuwa usługę programu VMM i wszystkie skojarzone maszyny wirtualne.
Składnia
Remove-SCService
[-VMMServer <ServerConnection>]
[-Service] <Service>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-SCService usuwa usługę programu Virtual Machine Manager (VMM) i wszystkie skojarzone maszyny wirtualne z hosta, na którym jest wdrażany. Usługa musi być w stanie zatrzymanym przed jego usunięciem. Aby zatrzymać usługę, użyj polecenia cmdlet Stop-SCService.
Przykłady
Przykład 1: Usuwanie określonej usługi wdrożonej na hoście
PS C:\> $Service = Get-SCService -VMMServer "VMMServer01.Contoso.com" -Name "Service01"
PS C:\> Stop-SCService -Service $Service
PS C:\> Remove-SCService -Service $Service -Confirm
Pierwsze polecenie pobiera obiekt usługi o nazwie Service01 na serwerze VMMServer01 i przechowuje obiekt w zmiennej $Service.
Drugie polecenie zatrzymuje usługę przechowywaną w $Service.
Ostatnie polecenie usuwa usługę przechowywaną w $Service i usuwa odpowiednie pliki maszyny wirtualnej z systemu plików. Przed usunięciem usługi zostanie wyświetlony monit o potwierdzenie.
Przykład 2. Usuwanie wszystkich usług z nazwami, które zawierają określony ciąg
PS C:\> $Services = Get-SCService -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "Service" }
PS C:\> $Services | Stop-SCService
PS C:\> $Services | Remove-SCService -Confirm
Pierwsze polecenie pobiera wszystkie obiekty usługi, które zawierają ciąg "Usługa" w nazwie, a następnie przechowuje obiekty w zmiennej $Services.
Drugie polecenie zatrzymuje wszystkie usługi przechowywane w $Service.
Trzecie polecenie usuwa wszystkie obiekty usługi zawarte w $Services i usuwa odpowiednie pliki maszyny wirtualnej z systemu plików. Przed usunięciem usługi zostanie wyświetlony monit o potwierdzenie.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-OnBehalfOfUser
Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-OnBehalfOfUserRole
Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole. To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.
Typ: | UserRole |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | Guid |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Service
Określa obiekt usługi programu VMM.
Typ: | Service |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-VMMServer
Określa obiekt serwera programu VMM.
Typ: | ServerConnection |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Domyślna wartość: | False |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |