Delen via

Publish-DscConfiguration

Module:
PSDesiredStateConfiguration Module v1.1

Hiermee publiceert u een DSC-configuratie naar een set computers.

Syntaxis

ComputerNameSet (Standaard) 

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

De Publish-DscConfiguration cmdlet publiceert een Windows PowerShell DSC-configuratiedocument (Desired State Configuration) op een set computers. Deze cmdlet past de configuratie niet toe. Configuraties worden toegepast door de Start-DscConfiguration-cmdlet wanneer deze wordt gebruikt met de parameter UseExisting of wanneer de DSC-engine de consistentiecyclus uitvoert. De DSC-engine wordt ook wel local Configuration Manager (LCM) genoemd.

Deze cmdlet is vooral handig wanneer fragmenten van meerdere configuratiedocumenten worden geleverd. Wanneer er meerdere configuratiedocumenten worden afgeleverd, overschrijven ze de oudere configuratiedocumentfragmenten.

Voorbeelden

Voorbeeld 1: Een configuratie publiceren op een externe computer

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

Met deze opdracht wordt een configuratie naar een externe computer gepubliceerd. De gebruiker die de cmdlet uitvoert, moet beheerder zijn op de externe computer.

Parameters

-CimSession

De cmdlet wordt uitgevoerd in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van een New-CimSession of Get-CimSession cmdlet. De standaardwaarde is de huidige sessie op de lokale computer.

Parametereigenschappen

Type:

CimSession[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

CimSessionSet
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ComputerName

Hiermee geeft u een of meer computers op waarop deze cmdlet de configuratie publiceert.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:China, Servernaam

Parametersets

ComputerNameSet
Position:1
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Credential

Hiermee geeft u referenties op die worden gebruikt voor toegang tot het doelapparaat.

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ComputerNameSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

Hiermee wordt de cmdlet gedwongen te voltooien. Als de lokale Configuration Manager-vernieuwingsmodus is ingesteld op PULL, wordt het gebruik van deze parameter gewijzigd in PUSH en wordt de publicatie van de DSC-configuratie ingeschakeld. Als er een DSC-configuratie in behandeling is, overschrijft het gebruik van deze parameter ook de configuratie die in behandeling is.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Path

Hiermee geeft u een pad op dat configuraties bevat die moeten worden gepubliceerd naar doelcomputers.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ThrottleLimit

Hiermee geeft u het maximum aantal gelijktijdige bewerkingen op dat kan worden ingesteld om de cmdlet uit te voeren. Als deze parameter wordt weggelaten of als er een waarde van 0 wordt ingevoerd, berekent Windows PowerShell een optimale beperkingslimiet voor de cmdlet op basis van het aantal CIM-cmdlets dat op de computer wordt uitgevoerd. De beperkingslimiet is alleen van toepassing op de huidige cmdlet, niet op de sessie of op de computer.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.