Condividi tramite

Start-DscConfiguration

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Applica la configurazione ai nodi.

Sintassi

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Descrizione

Il cmdlet Start-DscConfiguration applica la configurazione ai nodi. Se usato con il parametro UseExisting, viene applicata la configurazione esistente nel computer di destinazione. Specificare i computer a cui si desidera applicare la configurazione specificando i nomi dei computer o le sessioni CIM (Common Information Model).

Per impostazione predefinita, questo cmdlet crea un processo e restituisce un oggetto processo di. Per altre informazioni sui processi in background, digitare Get-Help about_Jobs. Per usare questo cmdlet in modo interattivo, specificare il parametro Wait.

Specificare il parametro dettagliato per visualizzare i dettagli delle operazioni del cmdlet quando si applicano le impostazioni di configurazione.

Esempio

Esempio 1: Applicare le impostazioni di configurazione

Start-DscConfiguration -Path "C:\DSC\Configurations\"

Questo comando applica le impostazioni di configurazione da C:\DSC\Configurations\ a ogni computer con impostazioni in tale cartella. Il comando restituisce oggetti job per ogni nodo di destinazione distribuito.

Esempio 2: Applicare le impostazioni di configurazione e attendere il completamento della configurazione

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

Questo comando applica la configurazione da C:\DSC\Configurations\ al computer locale. Il comando restituisce oggetti Job per ogni nodo di destinazione distribuito in, in questo caso solo il computer locale. In questo esempio viene specificato il parametro dettagliato. Di conseguenza, il comando invia messaggi alla console mentre procede. Il comando include il parametro Wait. Pertanto, non è possibile usare la console finché il comando non completa tutte le attività di configurazione.

Esempio 3: Applicare le impostazioni di configurazione usando una sessione CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

Questo esempio applica le impostazioni di configurazione a un computer specificato. Nell'esempio viene creata una sessione CIM per un computer denominato Server01 da usare con il cmdlet . In alternativa, creare una matrice di sessioni CIM per applicare il cmdlet a più computer specificati.

Il primo comando crea una sessione CIM usando il cmdlet New-CimSession e quindi archivia l'oggetto CimSession nella variabile $Session. Il comando richiede una password. Per altre informazioni, digitare Get-Help NewCimSession.

Il secondo comando applica le impostazioni di configurazione da C:\DSC\Configurations ai computer identificati dall'CimSession oggetti archiviati nella variabile $Session. In questo esempio la variabile $Session contiene una sessione CIM solo per il computer denominato Server01. Il comando applica la configurazione. Il comando crea oggetti processo per ogni computer configurato.

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 una matrice di nomi di computer. Questo parametro limita i computer con documenti di configurazione nel parametro Path a quelli specificati nella matrice.

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 un nome utente e una password, come oggetto PSCredential, per il computer di destinazione. Per ottenere un oggetto PSCredential, utilizzare il cmdlet Get-Credential. Per altre informazioni, digitare Get-Help Get-Credential.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Arresta l'operazione di configurazione attualmente in esecuzione nel computer di destinazione e avvia la nuova operazione di Start-Configuration. Se la proprietà RefreshMode di Gestione configurazione locale è impostata su pull, specificando questo parametro viene modificato in push.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobName

Specifica un nome descrittivo per un processo. Se si specifica questo parametro, il cmdlet viene eseguito come processo e restituisce un oggetto Job.

Per impostazione predefinita, Windows PowerShell assegna il nome JobN dove N è un numero intero.

Se si specifica il parametro wait, non specificare questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica un percorso di file di una cartella che contiene i file di impostazioni di configurazione. Questo cmdlet pubblica e applica queste impostazioni di configurazione ai computer con file di impostazioni nel percorso specificato. Ogni nodo di destinazione deve avere un file di impostazioni con il formato seguente: <NetBIOS Name>.mof.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:False
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

-UseExisting

Indica che questo cmdlet applica la configurazione esistente. La configurazione può esistere nel computer di destinazione applicando Start-DscConfiguration o tramite pubblicazione utilizzando il cmdlet Publish-DscConfiguration.

Prima di specificare questo parametro per questo cmdlet, esaminare le informazioni in Novità di Windows PowerShell 5.0.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Wait

Indica che il cmdlet blocca la console fino al termine di tutte le attività di configurazione.

Se si specifica questo parametro, non specificare il parametro JobName.

Tipo:SwitchParameter
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