Share via

Publish-DscConfiguration

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Pubblica una configurazione DSC in un set di computer.

Sintassi

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>]

Descrizione

Il Publish-DscConfiguration cmdlet pubblica un documento di configurazione Windows PowerShell Desired State Configuration (DSC) nel set di computer. Questo cmdlet non applica la configurazione. Le configurazioni vengono applicate dal cmdlet Start-DscConfiguration quando viene usato con il parametro UseExisting o quando il motore DSC esegue il ciclo di coerenza. Il motore DSC è noto anche come LCM (Local Configuration Manager).

Questo cmdlet è particolarmente utile quando vengono recapitati frammenti di più documenti di configurazione. Quando vengono recapitati più frammenti di documenti di configurazione, sovrascrive i frammenti di documento di configurazione meno recenti.

Esempio

Esempio 1: Pubblicare una configurazione in un computer remoto

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

Questo comando pubblica una configurazione in un computer remoto. L'utente che esegue il cmdlet deve essere amministratore nel computer remoto.

Parametri

-CimSession

Esegue il cmdlet in una sessione remota o in un computer remoto. Immettere un nome computer o un oggetto sessione, ad esempio l'output di un cmdlet New-CimSession o Get-CimSession. Il valore predefinito è la sessione corrente nel computer locale.

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

-ComputerName

Specifica uno o più computer in cui questo cmdlet pubblica la configurazione.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Credential

Specifica le credenziali usate per accedere al dispositivo di destinazione.

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

-Force

Forza il completamento del cmdlet. Se la modalità di aggiornamento locale Configuration Manager è impostata su PULL, l'utilizzo di questo parametro viene modificato in PUSH e consente la pubblicazione della configurazione DSC. Inoltre, se esiste una configurazione DSC in sospeso, l'utilizzo di questo parametro sovrascrive tale configurazione in sospeso.

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

-Path

Specifica un percorso che contiene configurazioni da pubblicare nei computer di destinazione.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Specifica il numero massimo di operazioni simultanee che è possibile stabilire per eseguire il cmdlet. Se questo parametro viene omesso o viene immesso un valore di 0 , Windows PowerShell calcola un limite ottimale per il cmdlet in base al numero di cmdlet in esecuzione nel computer. Questo valore limite su applica solo al cmdlet corrente, non alla sessione o al computer.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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