Get-DscConfiguration

  • Referentie
Module:
PSDesiredStateConfiguration

Hiermee haalt u de huidige configuratie van de knooppunten op.

Syntax

Get-DscConfiguration
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Description

De Get-DscConfiguration cmdlet haalt de huidige configuratie van de knooppunten op, als de configuratie bestaat. Geef computers op met behulp van CIM-sessies (Common Information Model). Als u geen doelcomputer opgeeft, haalt de cmdlet de configuratie op van de lokale computer.

Voorbeelden

Voorbeeld 1: De configuratie voor de lokale computer ophalen

Get-DscConfiguration

Met deze opdracht wordt de huidige status voor de lokale computer ophaalt.

Voorbeeld 2: De configuratie voor een opgegeven computer ophalen

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

In dit voorbeeld wordt de huidige status opgehaald van een computer die is opgegeven door een CIM-sessie. In het voorbeeld wordt een CIM-sessie gemaakt voor een computer met de naam Server01 voor gebruik met de cmdlet. U kunt ook een matrix van CIM-sessies maken om de cmdlet toe te passen op meerdere opgegeven computers.

Met de eerste opdracht maakt u een CIM-sessie met behulp van de New-CimSession cmdlet en slaat u vervolgens het CimSession-object op in de variabele $Session . De opdracht vraagt u om een wachtwoord. Typ Get-Help New-CimSession voor meer informatie.

Met de tweede opdracht wordt de huidige configuratie opgehaald voor de computers die worden geïdentificeerd door de CimSession-objecten die zijn opgeslagen in de variabele $Session , in dit geval de computer met de naam Server01.

Parameters

-AsJob

Geeft aan dat deze cmdlet de opdracht als een achtergrondtaak uitvoert.

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

-CimSession

Voert de cmdlet uit in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van een cmdlet New-CimSession of Get-CimSession . De standaardinstelling is de huidige sessie op de lokale computer.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Hiermee geeft u het maximum aantal gelijktijdige bewerkingen op dat kan worden ingesteld om de cmdlet uit te voeren. Als deze parameter wordt weggelaten of een waarde van 0 wordt ingevoerd, berekent Windows PowerShell een optimale beperkingslimiet voor de cmdlet op basis van het aantal CIM-cmdlets dat op de computer wordt uitgevoerd. De beperkingslimiet is alleen van toepassing op de huidige cmdlet, niet op de sessie of op de computer.

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