Condividi tramite

Set-DscLocalConfigurationManager

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Applica le impostazioni di Gestione configurazione locale ai nodi.

Sintassi

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-DscLocalConfigurationManager applica le impostazioni di Gestione configurazione locale o la metaconfigurazione ai nodi. Specificare i computer specificando i nomi dei computer o le sessioni CIM (Common Information Model). Se non si specifica un computer di destinazione, il cmdlet applica le impostazioni al computer locale.

Esempio

Esempio 1: Applicare le impostazioni di Gestione configurazione locale

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

Questo comando applica le impostazioni di Gestione configurazione locale da C:\DSC\Configurations\ ai nodi di destinazione. Dopo aver ricevuto le impostazioni, Gestione configurazione locale li elabora.

Avvertimento

Se sono presenti più meta mof per lo stesso computer archiviato nella cartella specificata, verrà applicato solo il primo meta mof.

Esempio 2: Applicare le impostazioni di Gestione configurazione locale usando una sessione CIM

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

Questo esempio applica le impostazioni di Gestione configurazione locale a un computer e applica le impostazioni. 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 New-CimSession.

Il secondo comando applica le impostazioni di Gestione configurazione locale per il nodo di destinazione da C:\DSC\Configurations\ al computer identificato 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 le impostazioni. Dopo aver ricevuto le impostazioni, Gestione configurazione locale li elabora.

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

Forza l'esecuzione del comando senza chiedere conferma dell'utente.

Tipo:SwitchParameter
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. Il cmdlet pubblica e applica queste impostazioni di Gestione configurazione locale 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.meta.mof.

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