Condividi tramite

Test-DscConfiguration

  • Riferimento
Modulo:
PSDesiredStateConfiguration

Verifica se la configurazione effettiva nei nodi corrisponde alla configurazione desiderata.

Sintassi

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Descrizione

Il Test-DscConfiguration cmdlet verifica se la configurazione effettiva nei nodi corrisponde alla configurazione desiderata. Specificare i computer per cui 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 verifica 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 verifica la configurazione per il computer locale.

Esempio 2: Testare la configurazione per un computer specificato

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

Questo esempio mostra come verificare la configurazione da un computer specificato tramite una sessione CIM. 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 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

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Questo comando verifica le configurazioni per un set di computer specificato dal parametro ComputerName 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

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Questo comando verifica le configurazioni definite in una cartella specificata dal parametro Path . Le configurazioni vengono testate su un set di computer, ognuno identificato dal nome file del file di configurazione.

Esempio 5: Testare le configurazioni specificate in un file

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

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 del computer remoto vengono automaticamente restituiti al computer locale. Per gestire il processo, utilizzare 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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 in cui questo cmdlet testa la configurazione. Il cmdlet verifica il documento di configurazione nel percorso specificato dal parametro Path a questi computer.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
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

-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 quali lo stato complessivo, le risorse nello stato desiderato, le risorse che non sono nello stato desiderato e il nome del computer.

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 di documento di configurazione. Il cmdlet testa la configurazione in base allo stato desiderato dei computer specificati dal parametro ComputerName o CimSession .

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

-ReferenceConfiguration

Specifica il percorso del file di documento di configurazione. Questo cmdlet testa la configurazione in base allo stato effettivo dei computer specificati dal parametro ComputerName o CimSession .

Type:String
Position:Named
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 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