Set-WSManInstance

Odwołanie

Moduł:: Microsoft.WSMan.Management

Modyfikuje informacje dotyczące zarządzania powiązane z zasobem.

Składnia

Set-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-Dialect <Uri>]
   [-FilePath <String>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [[-SelectorSet] <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Set-WSManInstance
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-FilePath <String>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-ResourceURI] <Uri>
   [[-SelectorSet] <Hashtable>]
   [-SessionOption <SessionOption>]
   [-ValueSet <Hashtable>]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

Opis

Polecenie Set-WSManInstance cmdlet modyfikuje informacje dotyczące zarządzania powiązane z zasobem.

To polecenie cmdlet używa warstwy połączenia/transportu usługi WinRM do modyfikowania informacji.

Przykłady

Przykład 1: Wyłączanie odbiornika na komputerze lokalnym

Set-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.171, ::1, 2001:4898:0:fff:0:5efe:172.30.168.171...}

To polecenie wyłącza odbiornik HTTPS na komputerze lokalnym.

Ważne

Parametr ValueSet uwzględnia wielkość liter podczas dopasowywania określonych właściwości.

Na przykład w tym poleceniu,

To kończy się niepowodzeniem: -ValueSet @{enabled="False"}

To powiedzie się: -ValueSet @{Enabled="False"}

Przykład 2. Ustawianie maksymalnego rozmiaru koperty na komputerze lokalnym

Set-WSManInstance -ResourceURI winrm/config -ValueSet @{MaxEnvelopeSizekb = "200"}

cfg                 : http://schemas.microsoft.com/wbem/wsman/1/config
lang                : en-US
MaxEnvelopeSizekb   : 200
MaxTimeoutms        : 60000
MaxBatchItems       : 32000
MaxProviderRequests : 4294967295
Client              : Client
Service             : Service
Winrs               : Winrs

To polecenie ustawia wartość MaxEnvelopeSizekb na wartość 200 na komputerze lokalnym.

Ważne

Parametr ValueSet uwzględnia wielkość liter podczas dopasowywania określonych właściwości.

Na przykład za pomocą powyższego polecenia.

To kończy się niepowodzeniem: -ValueSet @{MaxEnvelopeSizeKB ="200"}

To powiedzie się: -ValueSet @{MaxEnvelopeSizekb ="200"}

Przykład 3. Wyłączanie odbiornika na komputerze zdalnym

Set-WSManInstance -ResourceURI winrm/config/listener -ComputerName SERVER02 -SelectorSet @{address="*";transport="https"} -ValueSet @{Enabled="false"}

cfg                   : http://schemas.microsoft.com/wbem/wsman/1/config/listener
xsi                   : http://www.w3.org/2001/XMLSchema-instance
lang                  : en-US
Address               : *
Transport             : HTTPS
Port                  : 443
Hostname              :
Enabled               : false
URLPrefix             : wsman
CertificateThumbprint :
ListeningOn           : {127.0.0.1, 172.30.168.172, ::1, 2001:4898:0:fff:0:5efe:172.30.168.172...}

To polecenie wyłącza odbiornik HTTPS na komputerze zdalnym SERVER02.

Ważne

Parametr ValueSet uwzględnia wielkość liter podczas dopasowywania określonych właściwości.

Na przykład za pomocą powyższego polecenia.

To kończy się niepowodzeniem: -ValueSet @{enabled="False"}

To powiedzie się: -ValueSet @{Enabled="False"}

Parametry

-ApplicationName

Określa nazwę aplikacji w połączeniu. Wartość domyślna parametru ApplicationName to "WSMAN". Pełny identyfikator zdalnego punktu końcowego ma następujący format:

<transport>://<server>:<port>/<ApplicationName>

Na przykład:

http://server01:8080/WSMAN

Internet Information Services (IIS), który hostuje sesję, przekazuje żądania z tym punktem końcowym do określonej aplikacji. To ustawienie WSMAN domyślne programu jest odpowiednie dla większości zastosowań. Ten parametr jest przeznaczony do użycia, gdy wiele komputerów nawiązuje połączenia zdalne z jednym komputerem z uruchomionym programem Windows PowerShell. W takim przypadku usługi IIS hostuje usługi sieci Web do zarządzania (WS-Management) pod kątem wydajności.

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

-Authentication

Określa mechanizm uwierzytelniania, który ma być używany na serwerze. Dopuszczalne wartości:

Basic: Podstawowy to schemat, w którym nazwa użytkownika i hasło są wysyłane w postaci zwykłego tekstu do serwera lub serwera proxy.
Default : Użyj metody uwierzytelniania zaimplementowanej przez protokół WS-Management. Jest to opcja domyślna.
Digest: Skrót to schemat odpowiedzi wyzwania, który używa ciągu danych określonego przez serwer do wyzwania.
Kerberos: komputer kliencki i serwer wzajemnie się uwierzytelniają przy użyciu certyfikatów Protokołu Kerberos.
Negotiate: Negocjacja to schemat odpowiedzi wyzwania, który negocjuje z serwerem lub serwerem proxy w celu określenia schematu do użycia do uwierzytelniania. Na przykład ta wartość parametru pozwala negocjacjom określić, czy jest używany protokół Kerberos, czy NTLM.
CredSSP: Użyj uwierzytelniania dostawcy obsługi zabezpieczeń poświadczeń (CredSSP), które umożliwia użytkownikowi delegowanie poświadczeń. Ta opcja jest przeznaczona dla poleceń uruchamianych na jednym komputerze zdalnym, ale zbierać dane z lub uruchamiać dodatkowe polecenia na innych komputerach zdalnych.

Uwaga

Dostawca CredSSP deleguje poświadczenia użytkownika z komputera lokalnego do komputera zdalnego. Ta praktyka zwiększa ryzyko bezpieczeństwa operacji zdalnej. W przypadku naruszenia zabezpieczeń komputera zdalnego po przekazaniu do niego poświadczeń można użyć poświadczeń do kontrolowania sesji sieciowej.

Typ:	AuthenticationMechanism
Aliasy:	auth, am
Dopuszczalne wartości:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CertificateThumbprint

Określa cyfrowy certyfikat klucza publicznego (X509) konta użytkownika, które ma uprawnienia do wykonania tej akcji. Wprowadź odcisk palca certyfikatu.

Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Mogą być mapowane tylko na konta użytkowników lokalnych; nie działają z kontami domeny.

Aby uzyskać odcisk palca certyfikatu, użyj Get-Item polecenia lub Get-ChildItem na dysku programu PowerShell Cert: .

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

-ComputerName

Określa komputer, dla którego chcesz uruchomić operację zarządzania. Wartość może być w pełni kwalifikowaną nazwą domeny, nazwą NetBIOS lub adresem IP. Użyj nazwy komputera lokalnego, localhostlub kropki (.), aby określić komputer lokalny. Komputer lokalny jest domyślny.

Gdy komputer zdalny znajduje się w innej domenie niż użytkownik, należy użyć w pełni kwalifikowanej nazwy domeny. Do polecenia cmdlet można przekazać wartość tego parametru.

Typ:	String
Aliasy:	cn
Position:	Named
Domyślna wartość:	Localhost
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ConnectionURI

Określa punkt końcowy połączenia. Format tego ciągu to:

<Transport>://<Server>:<Port>/<ApplicationName>

Następujący ciąg jest poprawnie sformatowaną wartością dla tego parametru:

http://Server01:8080/WSMAN

Identyfikator URI musi być w pełni kwalifikowany.

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

-Credential

Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to użytkownik bieżący. Wpisz nazwę użytkownika, taką jak User01, Domain01\User01lub User@Domain.com. Alternatywnie wprowadź obiekt PSCredential , taki jak jeden zwrócony przez Get-Credential polecenie cmdlet. Podczas wpisywania nazwy użytkownika zostanie wyświetlony monit o podanie hasła.

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

-Dialect

Określa dialekt do użycia w predykacie filtru. Może to być każdy dialekt obsługiwany przez usługę zdalną. Dla identyfikatora URI dialektu można użyć następujących aliasów:

WQL: http://schemas.microsoft.com/wbem/wsman/1/WQL
Selector: http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
Association: http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter

Typ:	Uri
Position:	Named
Domyślna wartość:	http://schemas.microsoft.com/wbem/wsman/1/WQL
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FilePath

Określa ścieżkę pliku używanego do aktualizowania zasobu zarządzania. Zasób zarządzania określa się przy użyciu parametru ResourceURI i parametru SelectorSet . Na przykład następujące polecenie używa parametru FilePath :

Invoke-WSManAction -Action StopService -ResourceUri wmicimv2/Win32_Service -SelectorSet @{Name="spooler"} -FilePath:c:\input.xml -authentication default

To polecenie wywołuje metodę StopService w usłudze buforowania przy użyciu danych wejściowych z pliku. Plik Input.xml, zawiera następującą zawartość:

<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />

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

-Fragment

Określa sekcję wewnątrz wystąpienia, które ma zostać zaktualizowane lub pobrane dla określonej operacji. Aby na przykład uzyskać stan usługi buforowania, określ wartość -Fragment Status.

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

-OptionSet

Przekazuje zestaw przełączników do usługi w celu zmodyfikowania lub uściślinia charakteru żądania. Są one podobne do przełączników używanych w powłokach wiersza polecenia, ponieważ są one specyficzne dla usługi. Można określić dowolną liczbę opcji.

W poniższym przykładzie pokazano składnię przekazującą wartości 1, 2i 3 dla aparametrów , bi c :

-OptionSet @{a=1;b=2;c=3}

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

-Port

Określa port, który ma być używany, gdy klient nawiązuje połączenie z usługą WinRM. Gdy transport to HTTP, domyślny port to 80. Gdy transport to HTTPS, domyślny port to 443.

W przypadku używania protokołu HTTPS jako transportu wartość parametru ComputerName musi być zgodna z nazwą pospolitą certyfikatu serwera (CN). Jeśli jednak parametr SkipCNCheck jest określony jako część parametru SessionOption , nazwa pospolita certyfikatu serwera nie musi być zgodna z nazwą hosta serwera. Parametr SkipCNCheck powinien być używany tylko dla zaufanych maszyn.

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

-ResourceURI

Zawiera identyfikator URI (Uniform Resource Identifier) klasy zasobów lub wystąpienia. Identyfikator URI służy do identyfikowania określonego typu zasobu, takiego jak dyski lub procesy, na komputerze.

Identyfikator URI składa się z prefiksu i ścieżki do zasobu. Na przykład:

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Typ:	Uri
Aliasy:	ruri
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SelectorSet

Określa zestaw par wartości używanych do wybierania określonych wystąpień zasobów zarządzania. Parametr SelectorSet jest używany, gdy istnieje więcej niż jedno wystąpienie zasobu. Wartość parametru SelectorSet musi być tabelą skrótów. W poniższym przykładzie pokazano, jak wprowadzić wartość dla tego parametru:

-SelectorSet @{Name="WinRM";ID="yyy"}

Typ:	Hashtable
Position:	1
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-SessionOption

Definiuje zestaw opcji rozszerzonych dla sesji zarządzania usługami WS. Wprowadź obiekt SessionOption utworzony za New-WSManSessionOption pomocą polecenia cmdlet . Aby uzyskać więcej informacji na temat dostępnych opcji, zobacz New-WSManSessionOption.

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

-UseSSL

Określa, że protokół Secure Sockets Layer (SSL) powinien służyć do nawiązywania połączenia z komputerem zdalnym. Domyślnie nie jest używane szyfrowanie SSL.

Usługa WS-Management szyfruje całą zawartość programu Windows PowerShell przesyłaną przez sieć. Parametr UseSSL umożliwia określenie dodatkowej ochrony protokołu HTTPS zamiast protokołu HTTP. Jeśli protokół SSL nie jest dostępny na porcie używanym do połączenia i określisz ten parametr, polecenie zakończy się niepowodzeniem.

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

-ValueSet

Określa tabelę skrótów, która pomaga zmodyfikować zasób zarządzania. Zasób zarządzania określa się przy użyciu parametru ResourceURI i parametru SelectorSet . Wartość parametru ValueSet musi być tabelą skrótów.

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

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Udostępnij za pośrednictwem

Set-WSManInstance

Składnia

Opis

Przykłady

Przykład 1: Wyłączanie odbiornika na komputerze lokalnym

Przykład 2. Ustawianie maksymalnego rozmiaru koperty na komputerze lokalnym

Przykład 3. Wyłączanie odbiornika na komputerze zdalnym

Parametry

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-FilePath

-Fragment

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

Dane wejściowe

Dane wyjściowe

Dodatkowe zasoby

Udostępnij za pośrednictwem

Set-WSManInstance

Składnia

Opis

Przykłady

Przykład 1: Wyłączanie odbiornika na komputerze lokalnym

Przykład 2. Ustawianie maksymalnego rozmiaru koperty na komputerze lokalnym

Przykład 3. Wyłączanie odbiornika na komputerze zdalnym

Parametry

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConnectionURI

-Credential

-Dialect

-FilePath

-Fragment

-OptionSet

-Port

-ResourceURI

-SelectorSet

-SessionOption

-UseSSL

-ValueSet

Dane wejściowe

Dane wyjściowe

Linki powiązane

Dodatkowe zasoby