Set-Service

Set-Service
    [-Name] <String>
    [-DisplayName <String>]
    [-Credential <PSCredential>]
    [-Description <String>]
    [-StartupType <ServiceStartupType>]
    [-Status <String>]
    [-SecurityDescriptorSddl <String>]
    [-Force]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-Service
    [-InputObject] <ServiceController>
    [-DisplayName <String>]
    [-Credential <PSCredential>]
    [-Description <String>]
    [-StartupType <ServiceStartupType>]
    [-SecurityDescriptorSddl <String>]
    [-Status <String>]
    [-Force]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Cmdleten Set-Service ändrar egenskaperna för en tjänst, till exempel Status, Description, DisplayNameoch StartupType. Set-Service kan starta, stoppa, suspendera eller pausa en tjänst. Om du vill identifiera en tjänst anger du dess tjänstnamn eller skickar ett tjänstobjekt. Eller skicka ett tjänstnamn eller tjänstobjekt i pipelinen till Set-Service.

I det här exemplet ändras en tjänsts visningsnamn. Om du vill visa det ursprungliga visningsnamnet använder du Get-Service.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

Set-Service använder parametern Name för att ange tjänstens namn LanmanWorkstation. Parametern DisplayName anger det nya visningsnamnet LanMan Workstation.

Det här exemplet visar hur du ändrar en tjänsts starttyp.

Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status

Name  StartType   Status
----  ---------   ------
BITS  Automatic  Running

Set-Service använder parametern Name för att ange tjänstens namn, BITS. Parametern StartupType anger tjänsten till Automatisk.

Get-Service använder parametern Name för att ange tjänsten BITS och skickar objektet nedåt i pipelinen. Select-Object använder parametern Egenskap för att visa BITS--tjänstens status.

Det här exemplet ändrar BITS-tjänstens beskrivning och visar resultatet.

Cmdleten Get-CimInstance används eftersom den returnerar ett Win32_Service objekt som innehåller tjänstens Description.

Get-CimInstance Win32_Service -Filter 'Name = "BITS"'  | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
              disabled, then any applications that depend on BITS, such as Windows Update or MSN
              Explorer, will be unable to automatically download programs and other information.

Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List  Name, Description

Name        : BITS
Description : Transfers files in the background using idle network bandwidth.

Get-CimInstance skickar objektet nedåt i pipelinen till Format-List och visar tjänstens namn och beskrivning. I jämförelsesyfte körs kommandot före och efter att beskrivningen har uppdaterats.

Set-Service använder parametern Name för att ange tjänsten BITS. Parametern Description anger den uppdaterade texten för tjänstebeskrivningen.

I det här exemplet startas en tjänst.

Set-Service -Name WinRM -Status Running -PassThru

Status   Name               DisplayName
------   ----               -----------
Running  WinRM              Windows Remote Management (WS-Manag...

Set-Service använder parametern Name för att ange tjänsten WinRM. Parametern Status använder värdet Running för att starta tjänsten. Parametern PassThru matar ut ett ServiceController- objekt som visar resultatet.

I det här exemplet används pipelinen för att pausa för service.

Get-Service -Name Schedule | Set-Service -Status Paused

Get-Service använder parametern Name för att ange tjänsten Schedule och skickar objektet nedåt i pipelinen. Set-Service använder parametern Status för att ange att tjänsten ska pausas.

I det här exemplet används en variabel för att stoppa en tjänst.

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-Service använder parametern Name för att ange tjänsten Schedule. Objektet lagras i variabeln $S. Set-Service använder parametern InputObject och anger objektet som lagras $S. Parametern Status anger tjänsten till Stoppad.

Det här exemplet stoppar en tjänst på en fjärrdator. Mer information finns i Invoke-Command.

$Cred = Get-Credential
$S = Get-Service -Name Schedule
Invoke-Command -ComputerName server01.contoso.com -Credential $Cred -ScriptBlock {
  Set-Service -InputObject $S -Status Stopped
}

Get-Credential frågar efter ett användarnamn och lösenord och lagrar autentiseringsuppgifterna i variabeln $Cred. Get-Service använder parametern Name för att ange tjänsten Schedule. Objektet lagras i variabeln $S.

Invoke-Command använder parametern ComputerName för att ange en fjärrdator. Parametern Credential använder variabeln $Cred för att logga in på datorn. ScriptBlock- anropar Set-Service. Parametern InputObject anger tjänstobjektet som lagras $S. Parametern Status anger tjänsten till Stoppad.

I det här exemplet ändras de autentiseringsuppgifter som används för att hantera en tjänst.

$credential = Get-Credential
Set-Service -Name Schedule -Credential $credential

Get-Credential frågar efter ett användarnamn och lösenord och lagrar autentiseringsuppgifterna i variabeln $credential. Set-Service använder parametern Name för att ange tjänsten Schedule. Parametern Credential använder variabeln $credential och uppdaterar tjänsten Schedule.

Det här exemplet ändrar en tjänsts SecurityDescriptor.

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
Set-Service -Name "BITS" -SecurityDescriptorSddl $SDDL

SecurityDescriptor- lagras i variabeln $SDDL. Set-Service använder parametern Name för att ange tjänsten BITS. Parametern SecurityDescriptorSddl använder $SDDL för att ändra SecurityDescriptor- för tjänsten BITS.

Cmdleten Set-Service accepterar bara ett tjänstnamn i taget. Du kan dock skicka flera tjänster till Set-Service för att ändra konfigurationen av flera tjänster.

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka ett tjänstobjekt till den här cmdleten.

Du kan skicka en sträng som innehåller ett tjänstnamn till den här cmdleten.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten ett ServiceController--objekt.

Den här cmdleten är endast tillgänglig på Windows-plattformar.

Set-Service kräver utökade behörigheter. Använd alternativet Kör som administratör.

Set-Service kan bara styra tjänster när den aktuella användaren har behörighet att hantera tjänster. Om ett kommando inte fungerar korrekt kanske du inte har de behörigheter som krävs.

Om du vill hitta en tjänsts tjänstnamn eller visningsnamn använder du Get-Service. Tjänstnamnen finns i kolumnen Name och visningsnamnen finns i kolumnen DisplayName.