Dela via

Publish-DscConfiguration

Modul:
PSDesiredStateConfiguration Module v1.1

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

Syntax

ComputerNameSet (Standard) 

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

CimSessionSet 

Publish-DscConfiguration
    [-Path] <String>
    -CimSession <CimSession[]>
    [-Force]
    [-ThrottleLimit <Int32>]
    [-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.

Parameteregenskaper

Typ:

CimSession[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CimSessionSet
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ComputerName

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:CN, Servernamn

Parameteruppsättningar

ComputerNameSet
Position:1
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Credential

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

Parameteregenskaper

Typ:PSCredential
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ComputerNameSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Path

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

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.