Delen via

Publish-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

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

Syntaxis

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

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.

Type:CimSession[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

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

Type:String[]
Aliassen:CN, ServerName
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

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

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False