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 LCM (Local Configuration Manager).

Den här cmdleten är särskilt användbar när fragment av flera konfigurationsdokument levereras. När flera konfigurationsdokument har levererats skriver de över de äldre fragmenten i konfigurationsdokumentet.

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. Den användare 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 cmdleten New-CimSession eller Get-CimSession . Standardinställningen är den aktuella sessionen på den lokala datorn.

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

-ComputerName

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

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

-Confirm

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

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

-Credential

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

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

-Force

Tvingar cmdleten att slutföras. Om det lokala Configuration Manager uppdateringsläget ä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.

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

-Path

Anger en sökväg som innehåller konfigurationer för publicering till måldatorer.

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

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

-WhatIf

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

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