Set-DscLocalConfigurationManager

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Applica le impostazioni di Configuration Manager locali (LCM) 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 Set-DscLocalConfigurationManager cmdlet applica impostazioni LCM o metaconfigurazione ai nodi. Specificare i computer indicando i nomi di computer o tramite sessioni Common Information Model (CIM). Se non si specifica un computer di destinazione, il cmdlet applica le impostazioni al computer locale.

Esempio

Esempio 1: Applicare le impostazioni di LCM

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

Questo comando applica le impostazioni LCM dai C:\DSC\Configurations\ nodi di destinazione. Dopo aver ricevuto le impostazioni, LCM li elabora.

Avviso

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

Esempio 2: Applicare le impostazioni LCM 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 LCM a un computer e applica le impostazioni. 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 cmdlet e quindi archivia l'oggetto New-CimSessionCimSession nella $Session variabile. Il comando richiede l'immissione di una password. Per ulteriori informazioni, digitare Get-Help New-CimSession.

Il secondo comando applica le impostazioni LCM per il nodo di destinazione dal C:\DSC\Configurations\ computer identificato 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 le impostazioni. Dopo aver ricevuto le impostazioni, LCM 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 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 meta-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, usare il cmdlet Get-Credential. 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

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

Type:SwitchParameter
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. Il cmdlet pubblica e applica queste impostazioni LCM ai computer con file di impostazioni nel percorso specificato. Ogni nodo di destinazione deve avere un file di impostazioni del formato seguente: NetBIOS Name.meta.mof.

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

-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