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
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
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
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CimSessionAndUseExistingSet
Posizione:
Named
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
ComputerNameAndUseExistingSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CimSessionAndPathSet
Posizione:
0
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
