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 Start-DscConfiguration cmdlet 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 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 Job. 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 Verbose per visualizzare i dettagli delle operazioni eseguite dal cmdlet quando applica 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 della distribuzione.

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 della distribuzione, in questo caso solo il computer locale. In questo esempio viene specificato il parametro Verbose . Pertanto, il comando invia messaggi alla console man mano che 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 mostra come applicare le impostazioni di configurazione a un computer specificato. L'esempio crea una sessione CIM da usare con il cmdlet per un computer denominato Server01. In alternativa, è possibile creare una matrice di sessioni CIM per applicare il cmdlet a più computer specificati.

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

Il secondo comando applica le impostazioni di configurazione dai C:\DSC\Configurations computer identificati dagli oggetti CimSession archiviati nella $Session variabile . In questo esempio la $Session variabile contiene una sessione CIM solo per il computer denominato Server01. Il comando applica la configurazione. Il comando crea gli oggetti Job 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 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 una matrice di nomi di computer. Questo parametro limita i computer con documenti di configurazione nel parametro Path a quelli specificati nella matrice.

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 del Configuration Manager locale è impostata su Pull, specificando questo parametro viene modificato in Push.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Path

Specifica il percorso di una cartella che contiene i file delle 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.

Type:String
Position:0
Default value:None
Required:False
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 di limitazione ottimale per il cmdlet in base al numero di cmdlet CIM 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

-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 What's New in Windows PowerShell 5.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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