Dela via

Publish-DscConfiguration

  • Referens
Modul:
PSDesiredStateConfiguration

Publicerar en DSC-konfiguration till en uppsättning datorer.

Syntax

Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [[-ComputerName] <String[]>]
       [-Credential <PSCredential>]
       [-ThrottleLimit <Int32>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-DscConfiguration
       [-Path] <String>
       [-Force]
       [-ThrottleLimit <Int32>]
       -CimSession <CimSession[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Cmdleten Publish-DscConfiguration publicerar ett konfigurationsdokument för Windows PowerShell Desired State Configuration (DSC) på en uppsättning datorer. Den här cmdleten tillämpar inte konfigurationen. Konfigurationer tillämpas antingen av cmdleten Start-DscConfiguration när den används med parametern UseExisting eller när DSC-motorn kör sin konsekvenscykel. DSC-motorn kallas även för Local Configuration Manager (LCM).

Den här cmdleten är särskilt användbar när fragment av flera konfigurationsdokument levereras. När flera konfigurationsdokument levereras skriver de över de äldre konfigurationsdokumentfragmenten.

Exempel

Exempel 1: Publicera en konfiguration till en fjärrdator

Publish-DscConfiguration -Path '$home\WebServer' -ComputerName "ContosoWebServer" -Credential (get-credential Contoso\webadministrator)

Det här kommandot publicerar en konfiguration till en fjärrdator. Användaren som kör cmdleten ska vara administratör på fjärrdatorn.

Parametrar

-CimSession

Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från en New-CimSession- eller Get-CimSession cmdlet. Standardvärdet är den aktuella sessionen på den lokala datorn.

Typ:CimSession[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

Anger en eller flera datorer där den här cmdleten publicerar konfigurationen.

Typ:String[]
Alias:CN, ServerName
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger autentiseringsuppgifter som används för att komma åt målenheten.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvingar cmdleten att slutföras. Om uppdateringsläget för Local Configuration Manager är inställt på PULL ändrar användningen av den här parametern den till PUSH och aktiverar publicering av DSC-konfigurationen. Om det finns en väntande DSC-konfiguration skriver användningen av den här parametern över den väntande konfigurationen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en sökväg som innehåller konfigurationer som ska publiceras på måldatorer.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ThrottleLimit

Anger det maximala antalet samtidiga åtgärder som kan upprättas för att köra cmdleten. Om den här parametern utelämnas eller ett värde på 0 anges beräknar Windows PowerShell en optimal begränsningsgräns för cmdleten baserat på antalet CIM-cmdletar som körs på datorn. Begränsningsgränsen gäller endast för den aktuella cmdleten, inte för sessionen eller på datorn.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False