Udostępnij za pośrednictwem

Set-DscLocalConfigurationManager

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Stosuje ustawienia lokalnego 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 Set-DscLocalConfigurationManager cmdlet stosuje ustawienia LCM lub meta-konfigurację do węzłów. Określ komputery, określając nazwy komputerów lub używając sesji modelu wspólnych informacji (CIM). Jeśli nie określisz komputera docelowego, 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ń program LCM przetwarza je.

Ostrzeżenie

Jeśli istnieje wiele meta mofs dla tego samego komputera przechowywanego w określonym folderze, zostanie zastosowany tylko pierwszy meta mof.

Przykład 2. Stosowanie ustawień LCM przy użyciu sesji ciągłej integracji

$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 ciągłej integracji 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ę CIM przy użyciu New-CimSession polecenia cmdlet, a następnie przechowuje obiekt CimSession w zmiennej $Session . Polecenie wyświetla monit o hasło. Aby uzyskać więcej informacji, wpisz polecenie Get-Help New-CimSession.

Drugie polecenie stosuje ustawienia LCM dla węzła docelowego z C:\DSC\Configurations\ komputera zidentyfikowanego przez obiekty CimSession przechowywane w zmiennej $Session . W tym przykładzie zmienna $Session zawiera sesję ciM tylko dla komputera o nazwie Server01. Polecenie stosuje ustawienia. Po otrzymaniu ustawień program 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.

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

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 polecenie Get-Help Get-Credential.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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, Windows PowerShell oblicza optymalny limit ograniczania dla polecenia cmdlet na podstawie liczby poleceń cmdlet, które są uruchomione na komputerze. Limit ograniczania dotyczy tylko bieżącego polecenia cmdlet, a nie sesji lub komputera.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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