Set-DscLocalConfigurationManager
Stosuje ustawienia programu Local Configuration Manager (LCM) do węzłów.
Składnia
ComputerNameSet (Domyślna)
Set-DscLocalConfigurationManager
[-Path] <String>
[[-ComputerName] <String[]>]
[-Force]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Set-DscLocalConfigurationManager
[-Path] <String>
-CimSession <CimSession[]>
[-Force]
[-ThrottleLimit <Int32>]
[-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.
Właściwości parametru
| Typ: | |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
CimSessionSet
| Position: | Named |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | CN, NazwaSerwera |
Zestawy parametrów
ComputerNameSet
| Position: | 1 |
| Obowiązkowy: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerNameSet
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
