New-WSManInstance
建立管理資源的新實例。
語法
New-WSManInstance
[-ApplicationName <String>]
[-ComputerName <String>]
[-FilePath <String>]
[-OptionSet <Hashtable>]
[-Port <Int32>]
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-SessionOption <SessionOption>]
[-UseSSL]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>] New-WSManInstance
[-ConnectionURI <Uri>]
[-FilePath <String>]
[-OptionSet <Hashtable>]
[-ResourceURI] <Uri>
[-SelectorSet] <Hashtable>
[-SessionOption <SessionOption>]
[-ValueSet <Hashtable>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>] Description
New-WSManInstance Cmdlet 會建立管理資源的新實例。 它會使用資源 URI 和值集或輸入檔來建立管理資源的新實例。
此 Cmdlet 會使用 WinRM 連線/傳輸層來建立管理資源實例。
範例
範例 1
PS> New-WSManInstance winrm/config/Listener -SelectorSet @{Transport=HTTPS} -ValueSet @{Hostname="HOST";CertificateThumbprint="XXXXXXXXXX"}此命令會在所有IP位址上建立 WS-Management HTTPS 接聽程序的實例。
參數
-ApplicationName
指定連接中的應用程式名稱。 ApplicationName 參數的預設值為 「WSMAN」。。 遠端端端點的完整識別碼格式如下：
<傳輸>：//<伺服器>：<埠>/<ApplicationName>
例如：
http://server01:8080/WSMAN
裝載會話的 Internet Information Services （IIS）會將具有此端點的要求轉送至指定的應用程式。 此預設設定 「WSMAN」 適用於大部分用途。 當許多計算機與一部執行 Windows PowerShell 的電腦建立遠端連線時，這個參數是設計成使用。 在此情況下，IIS 會裝載 Web Services for Management （WS-Management），以提高效率。
| 類型: | String |
| Position: | Named |
| 預設值: | Wsman |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Authentication
指定要在伺服器上使用的驗證機制。 可能的值為：
- 基本：基本是一種配置，其中使用者名稱和密碼會以純文本傳送至伺服器或 Proxy。
- 預設：使用 WS-Management 通訊協定所實作的驗證方法。 這是預設值。
- 摘要：摘要是一種挑戰回應配置，使用伺服器指定的數據字串來進行挑戰。
- Kerberos：用戶端計算機和伺服器會使用 Kerberos 憑證相互驗證。
- 交涉：交涉是一種挑戰回應配置，會與伺服器或 Proxy 交涉，以判斷要用於驗證的配置。 例如，此參數值允許交涉來判斷是否使用 Kerberos 通訊協定或 NTLM。
- CredSSP：使用認證安全性支援提供者 （CredSSP） 驗證，可讓使用者委派認證。 此選項是針對在一部遠端電腦上執行的命令所設計，但從其他遠端電腦上收集資料或執行其他命令。
注意：CredSSP 會將用戶的認證從本機計算機委派給遠端計算機。 這種做法會增加遠端作業的安全性風險。 如果遠端電腦遭到入侵，當認證傳遞至該計算機時，可以使用認證來控制網路會話。
| 類型: | AuthenticationMechanism |
| 別名: | auth, am |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CertificateThumbprint
指定具有執行此動作許可權之用戶帳戶的數位公鑰憑證 （X509）。 輸入憑證的憑證指紋。
憑證用於客戶端憑證型驗證。 它們只能對應至本機用戶帳戶;它們不適用於網域帳戶。
若要取得憑證指紋，請使用 Windows PowerShell 憑證：磁碟驅動器中的 Get-Item 或 Get-ChildItem 命令。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ComputerName
指定您要執行管理作業的電腦。 此值可以是完整功能變數名稱、NetBIOS 名稱或IP位址。 使用本機計算機名稱、使用localhost，或使用點 （.） 來指定本機電腦。 本機計算機是預設值。 當遠端電腦位於與使用者不同的網域時，您必須使用完整功能變數名稱。 您可以使用管線將此參數的值傳送至 Cmdlet。
| 類型: | String |
| 別名: | cn |
| Position: | Named |
| 預設值: | Localhost |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ConnectionURI
指定連接端點。 此字串格式為：
<傳輸>：//<Server>：<埠>/<ApplicationName>
下列字串是此參數格式正確的值：
http://Server01:8080/WSMAN
URI 必須完整。
| 類型: | Uri |
| 別名: | CURI, CU |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
指定具有執行此動作許可權的用戶帳戶。 預設值為目前的使用者。 輸入用戶名稱，例如 「User01」、“ Domain01\User01” 或 「User@Domain.com」。 或者，輸入 PSCredential 物件，例如 Get-Credential Cmdlet 所傳回的物件。 當您輸入使用者名稱時，系統會提示您輸入密碼。
| 類型: | PSCredential |
| 別名: | cred, c |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-FilePath
指定用來建立管理資源的檔案路徑。 您可以使用 ResourceURI 參數和 SelectorSet 參數來指定管理資源。 例如，下列命令使用 File 參數：
invoke-wsmanaction -action stopservice -resourceuri wmicimv2/Win32_Service -SelectorSet @{Name=“spooler”} -File c：\input.xml -authentication 預設值
此命令會使用檔案的輸入，呼叫 Spooler 服務上的 StopService 方法 [描述元]。 檔案 Input.xml包含下列內容：
<p:StopService_INPUT xmlns:p="https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OptionSet
將一組參數傳遞至服務，以修改或精簡要求的性質。 這些參數類似於命令行殼層中使用的參數，因為它們是特定的服務。 您可以指定任意數目的選項。
下列範例示範傳遞 a、b 和 c 參數值 1、2 和 3 的語法：
-OptionSet @{a=1;b=2;c=3}
| 類型: | Hashtable |
| 別名: | os |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Port
指定客戶端連線到 WinRM 服務時要使用的埠。 當傳輸為 HTTP 時，預設埠為 80。 當傳輸是 HTTPS 時，預設埠為 443。 當您使用 HTTPS 做為傳輸時，ComputerName 參數的值必須符合伺服器的憑證一般名稱 （CN）。 不過，如果 SkipCNCheck 參數指定為 SessionOption 參數的一部分，則伺服器的憑證一般名稱不需要符合伺服器的主機名。 SkipCNCheck 參數應該只用於信任的電腦。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ResourceURI
包含資源類別或實例的統一資源標識碼 （URI）。 URI 可用來識別電腦上的特定資源類型，例如磁碟或進程。
URI 包含前置詞和資源的路徑。 例如：
https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
| 類型: | Uri |
| 別名: | ruri |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SelectorSet
指定一組值組，用來選取特定的管理資源實例。 當資源有多個實例存在時，就會使用 SelectorSet 參數。 SelectorSet 參數的值必須是哈希表。
下列範例示範如何輸入此參數的值：
-SelectorSet @{Name=“WinRM”;ID=“yyy”}
| 類型: | Hashtable |
| Position: | 2 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SessionOption
定義一組 WS-Management 會話的擴充選項。 輸入您使用 New-WSManSessionOption Cmdlet 建立的 SessionOption 物件。 如需可用選項的詳細資訊，請參閱 New-WSManSessionOption。
| 類型: | SessionOption |
| 別名: | so |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UseSSL
指定安全套接字層 （SSL） 通訊協議應該用來建立與遠端電腦的連線。 根據預設，不會使用 SSL。
WS-Management 會加密透過網路傳輸的所有 Windows PowerShell 內容。 UseSSL 參數可讓您指定 HTTPS 的額外保護，而不是 HTTP。 如果用於連線的埠上無法使用 SSL，而且您指定此參數，命令會失敗。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ValueSet
指定可協助修改管理資源的哈希表。 您可以使用 ResourceURI 參數和 SelectorSet 參數來指定管理資源。 ValueSet 參數的值必須是哈希表。
| 類型: | Hashtable |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
此 Cmdlet 不接受任何輸入。
輸出
None
此 Cmdlet 不會產生任何輸出。
備註
- Windows Management Instrumentation （WMI） Cmdlet Set-WmiInstance Cmdlet 很類似。 Set-WmiInstance 使用DCOM連線/傳輸層來建立或更新 WMI 實例。