Share via

Publish-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

Publiceert een DSC-configuratie naar een set computers.

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

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

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

Voorbeelden

Voorbeeld 1: Een configuratie publiceren naar een externe computer

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

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

Parameters

-CimSession

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

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Hiermee dwingt u de cmdlet te voltooien. Als de lokale Configuration Manager vernieuwingsmodus is ingesteld op PULL, wordt deze door het gebruik van deze parameter gewijzigd in PUSH en kan de DSC-configuratie worden gepubliceerd. Als er een DSC-configuratie in behandeling is, overschrijft het gebruik van deze parameter de configuratie die in behandeling is.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Hiermee geeft u een pad op dat configuraties bevat om te publiceren naar doelcomputers.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False