Il Test-DscConfiguration cmdlet verifica se la configurazione effettiva nei nodi corrisponde alla configurazione desiderata. Specificare i computer per i quali si desidera testare le configurazioni usando nomi di computer o sessioni CIM (Common Information Model). Se non si specifica un computer di destinazione, il cmdlet testa la configurazione del computer locale.
Se le configurazioni desiderate e effettive corrispondono, il cmdlet restituisce un valore stringa "True".
In caso contrario, restituisce un valore stringa "False".
Esempio
Esempio 1: Testare la configurazione per il computer locale
Test-DscConfiguration
Questo comando testa la configurazione per il computer locale.
Esempio 2: Testare la configurazione per un computer specificato
In questo esempio viene testata la configurazione da un computer specificato da una sessione CIM. 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 verifica la configurazione per i computer identificati dagli oggetti CimSession archiviati nella $Session variabile, in questo caso il computer denominato Server01.
Esempio 3: Testare le configurazioni con risultati dettagliati
Questo comando testa le configurazioni per un set di computer specificato dal parametro NomeComputer e restituisce informazioni dettagliate che includono lo stato complessivo, le risorse nello stato desiderato, le risorse che non si trovano nello stato desiderato e nel nome del computer.
Esempio 4: Testare le configurazioni specificate in una cartella
Questo comando verifica le configurazioni definite in una cartella specificata dal parametro Path .
Le configurazioni vengono testate su un set di computer, ognuna identificata dal nome file del file di configurazione.
Esempio 5: Testare le configurazioni specificate in un file
Questo comando verifica una configurazione definita in un file su un set di computer specificato dal parametro ComputerName .
Parametri
-AsJob
Indica che questo cmdlet esegue il comando come processo in background.
Se si specifica il parametro AsJob, il comando restituisce un oggetto che rappresenta il processo e quindi visualizza il prompt dei comandi. È possibile continuare a lavorare nella sessione fino al termine del processo.
Il processo viene creato nel computer locale e i risultati dei computer remoti vengono restituiti automaticamente al computer locale. Per gestire il processo, usare i cmdlet job. Per ottenere i risultati del processo, usare il Receive-Job cmdlet .
Per usare questo parametro, i computer locali e remoti devono essere configurati per la comunicazione remota e in Windows Vista e versioni successive del sistema operativo Windows, è necessario aprire Windows PowerShell con l'opzione Esegui come amministratore. Per altre informazioni, vedere about_Remote_Requirements.
Per altre informazioni sui processi in background di Windows PowerShell, vedere about_Jobs e about_Remote_Jobs.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-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
CimSessionAndReferenceConfigurationSet
Posizione:
Named
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CimSessionSet
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 in cui questo cmdlet testa la configurazione. Il cmdlet verifica il documento di configurazione nel percorso specificato dal parametro percorso a questi computer.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
ComputerNameAndPathSet
Posizione:
1
Obbligatorio:
False
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
ComputerNameAndReferenceConfigurationSet
Posizione:
1
Obbligatorio:
False
Valore dalla pipeline:
True
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
ComputerNameAndPathSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
ComputerNameAndReferenceConfigurationSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Detailed
Indica che questo cmdlet restituisce un risultato dettagliato del confronto del documento di configurazione con lo stato desiderato dei nodi. Il risultato include informazioni come lo stato complessivo, le risorse nello stato desiderato, le risorse che non sono nello stato desiderato e il nome del computer.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CimSessionSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Path
Specifica il percorso di una cartella contenente i file di documento di configurazione. Il cmdlet verifica la configurazione in base allo stato desiderato dei computer specificati dal parametro ComputerName o CimSession.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CimSessionAndPathSet
Posizione:
0
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-ReferenceConfiguration
Specifica il percorso del file di documento di configurazione. Questo cmdlet verifica la configurazione in base allo stato effettivo dei computer specificati dal parametro ComputerName o CimSession.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CimSessionAndReferenceConfigurationSet
Posizione:
Named
Obbligatorio:
True
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
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.
