Udostępnij za pośrednictwem

Set-DscLocalConfigurationManager

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Stosuje ustawienia programu Local Configuration Manager (LCM) do węzłów.

Składnia

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>]

Opis

Polecenie cmdlet Set-DscLocalConfigurationManager stosuje ustawienia LCM lub meta-konfigurację do węzłów. Określ komputery, określając nazwy komputerów lub przy użyciu sesji modelu wspólnych informacji (CIM). Jeśli komputer docelowy nie zostanie określony, polecenie cmdlet zastosuje ustawienia do komputera lokalnego.

Przykłady

Przykład 1. Stosowanie ustawień LCM

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

To polecenie stosuje ustawienia LCM z C:\DSC\Configurations\ do węzłów docelowych. Po otrzymaniu ustawień usługa LCM przetwarza je.

Ostrzeżenie

Jeśli istnieje wiele metamof dla tego samego komputera przechowywanego w określonym folderze, zostaną zastosowane tylko pierwsze metamof.

Przykład 2. Stosowanie ustawień LCM przy użyciu sesji modelu CIM

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\" -CimSession $Session

Ten przykład stosuje ustawienia LCM do komputera i stosuje ustawienia. 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 stosuje ustawienia LCM dla węzła docelowego z C:\DSC\Configurations\ do komputera zidentyfikowanego przez CimSession obiektów przechowywanych w zmiennej $Session. W tym przykładzie zmienna $Session zawiera sesję modelu ciągłej integracji tylko dla komputera o nazwie Server01. Polecenie stosuje ustawienia. Po otrzymaniu ustawień usługa LCM przetwarza je.

Parametry

-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[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ComputerName

Określa tablicę nazw komputerów. Ten parametr ogranicza komputery, które mają dokumenty meta-konfiguracji w Path parametr do tych określonych w tablicy.

Typ:String[]
Aliasy:CN, ServerName
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Określa nazwę użytkownika i hasło jako obiekt PSCredential dla komputera docelowego. Aby uzyskać obiekt PSCredential, użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę pliku folderu zawierającego pliki ustawień konfiguracji. Polecenie cmdlet publikuje i stosuje te ustawienia LCM do komputerów z plikami ustawień w określonej ścieżce. Każdy węzeł docelowy musi mieć plik ustawień w następującym formacie: NetBIOS Name.meta.mof.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
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

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False