Get-DscConfiguration
Pobiera bieżącą konfigurację węzłów.
Składnia
Get-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Opis
Polecenie cmdlet Get-DscConfiguration
pobiera bieżącą konfigurację węzłów, jeśli konfiguracja istnieje. Określ komputery przy użyciu sesji modelu wspólnych informacji (CIM). Jeśli komputer docelowy nie zostanie określony, polecenie cmdlet pobierze konfigurację z komputera lokalnego.
Przykłady
Przykład 1. Pobieranie konfiguracji komputera lokalnego
Get-DscConfiguration
To polecenie pobiera bieżący stan komputera lokalnego.
Przykład 2. Pobieranie konfiguracji dla określonego komputera
$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Get-DscConfiguration -CimSession $Session
W tym przykładzie jest pobierany bieżący stan z komputera określonego przez sesję modelu CIM. W przykładzie jest tworzona sesja modelu ciM dla komputera o nazwie Server01 do użycia z poleceniem cmdlet . Alternatywnie utwórz tablicę sesji ciM, aby zastosować polecenie cmdlet do wielu określonych komputerów.
Pierwsze polecenie tworzy sesję modelu CIM przy użyciu polecenia cmdlet New-CimSession
, a następnie przechowuje obiekt CimSession w zmiennej $Session. Polecenie wyświetla monit o podanie hasła. Aby uzyskać więcej informacji, wpisz Get-Help New-CimSession
.
Drugie polecenie pobiera bieżącą konfigurację komputerów zidentyfikowanych przez CimSession obiektów przechowywanych w zmiennej $Session, w tym przypadku komputera o nazwie Server01.
Parametry
-AsJob
Wskazuje, że to polecenie cmdlet uruchamia polecenie jako zadanie w tle.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-CimSession
Uruchamia polecenie cmdlet w sesji zdalnej lub na komputerze zdalnym. Wprowadź nazwę komputera lub obiekt sesji, taki jak dane wyjściowe polecenia cmdlet New-CimSession lub Get-CimSession. Wartość domyślna to bieżąca sesja na komputerze lokalnym.
Typ: | CimSession[] |
Aliasy: | Session |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ThrottleLimit
Określa maksymalną liczbę współbieżnych operacji, które można ustanowić w celu uruchomienia polecenia cmdlet. Jeśli ten parametr zostanie pominięty lub zostanie wprowadzona wartość 0
, program Windows PowerShell oblicza optymalny limit ograniczania dla polecenia cmdlet na podstawie liczby poleceń cmdlet ciM uruchomionych na komputerze. Limit ograniczania dotyczy tylko bieżącego polecenia cmdlet, a nie sesji lub komputera.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |