Publish-DscConfiguration
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 cmdlet Publish-DscConfiguration
pubblica un documento di configurazione dsc (Desired State Configuration) di Windows PowerShell in un 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 Gestione configurazione locale.
Questo cmdlet è particolarmente utile quando vengono recapitati frammenti di più documenti di configurazione. Quando vengono recapitati più frammenti di documenti di configurazione, sovrascrivono i frammenti di documento di configurazione precedenti.
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 New-CimSession o cmdlet Get-CimSession. Il valore predefinito è la sessione corrente nel computer locale.
Tipo: | CimSession[] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ComputerName
Specifica uno o più computer in cui questo cmdlet pubblica la configurazione.
Tipo: | String[] |
Alias: | CN, ServerName |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Credential
Specifica le credenziali usate per accedere al dispositivo di destinazione.
Tipo: | PSCredential |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Force
Forza il completamento del cmdlet. Se la modalità di aggiornamento di Gestione configurazione locale è impostata su PULL, l'utilizzo di questo parametro lo modifica in PUSH e abilita la pubblicazione della configurazione DSC. Inoltre, se esiste una configurazione DSC in sospeso, l'utilizzo di questo parametro sovrascrive tale configurazione in sospeso.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Path
Specifica un percorso che contiene le configurazioni da pubblicare nei computer di destinazione.
Tipo: | String |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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 di limitazione ottimale per il cmdlet in base al numero di cmdlet CIM in esecuzione nel computer. Il limite di limitazione si applica solo al cmdlet corrente, non alla sessione o al computer.
Tipo: | Int32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Alias: | wi |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |