New-WSManInstance
Skapar en ny instans av en hanteringsresurs.
Syntax
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
Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten New-WSManInstance
skapar en ny instans av en hanteringsresurs. Den använder en resurs-URI och en värdeuppsättning eller indatafil för att skapa den nya instansen av hanteringsresursen.
Den här cmdleten använder WinRM-anslutnings-/transportlagret för att skapa hanteringsresursinstansen.
Exempel
Exempel 1: Skapa en HTTPS-lyssnare
Det här kommandot skapar en instans av en WS-Management HTTPS-lyssnare på alla IP-adresser.
New-WSManInstance winrm/config/Listener -SelectorSet @{Transport='HTTPS'; Address='*'} -ValueSet @{Hostname="HOST";CertificateThumbprint="XXXXXXXXXX"}
Parametrar
-ApplicationName
Anger programnamnet i anslutningen. Standardvärdet för parametern ApplicationName är WSMAN. Den fullständiga identifieraren för fjärrslutpunkten har följande format:
<transport>://<server>:<port>/<ApplicationName>
Exempel:
http://server01:8080/WSMAN
Internet Information Services (IIS), som är värd för sessionen, vidarebefordrar begäranden med den här slutpunkten till det angivna programmet. Den här standardinställningen för WSMAN är lämplig för de flesta användningsområden. Den här parametern är utformad för att användas när flera datorer upprättar fjärranslutningar till en dator som kör Windows PowerShell. I det här fallet är IIS värd för Web Services for Management (WS-Management) för effektivitet.
Type: | String |
Position: | Named |
Default value: | Wsman |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
Anger vilken autentiseringsmekanism som ska användas på servern. Möjliga värden:
- Grundläggande: Basic är ett schema där användarnamnet och lösenordet skickas i klartext till servern eller proxyn.
- Standard: Använd autentiseringsmetoden som implementeras av WS-Management-protokollet. Det här är standardinställningen.
- Sammanfattad: Sammandrag är ett utmaningssvarsschema som använder en server angiven datasträng för utmaningen.
- Kerberos: Klientdatorn och servern autentiseras ömsesidigt med Hjälp av Kerberos-certifikat.
- Förhandla: Förhandla är ett svarsschema som förhandlar med servern eller proxyservern för att fastställa vilket schema som ska användas för autentisering. Till exempel tillåter det här parametervärdet förhandling för att avgöra om Kerberos-protokollet eller NTLM används.
- CredSSP: Använd CredSSP-autentisering (CredSSP) som gör att användaren kan delegera autentiseringsuppgifter. Det här alternativet är utformat för kommandon som körs på en fjärrdator men samlar in data från eller kör ytterligare kommandon på andra fjärrdatorer.
Varning
CredSSP delegerar användarens autentiseringsuppgifter från den lokala datorn till en fjärrdator. Den här metoden ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan autentiseringsuppgifterna användas för att styra nätverkssessionen när autentiseringsuppgifterna skickas till den.
Type: | AuthenticationMechanism |
Aliases: | auth, am |
Accepted values: | None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Anger certifikatet för den digitala offentliga nyckeln (X509) för ett användarkonto som har behörighet att utföra den här åtgärden. Ange certifikatets tumavtryck.
Certifikat används i klientcertifikatbaserad autentisering. De kan endast mappas till lokala användarkonton. de fungerar inte med domänkonton.
Om du vill hämta ett tumavtryck för certifikatet Get-Item
använder du kommandot eller Get-ChildItem
i PowerShell Cert:-enheten.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Anger den dator som du vill köra hanteringsåtgärden mot. Värdet kan vara ett fullständigt kvalificerat domännamn, ett NetBIOS-namn eller en IP-adress. Använd namnet på den lokala datorn, använd localhost eller använd en punkt (.
) för att ange den lokala datorn. Den lokala datorn är standard. När fjärrdatorn finns i en annan domän än användaren måste du använda ett fullständigt kvalificerat domännamn. Du kan skicka ett värde för den här parametern till cmdleten .
Type: | String |
Aliases: | cn |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionURI
Anger anslutningsslutpunkten. Formatet för den här strängen är:
<Transport>://<Server>:<Port>/<ApplicationName>
Följande sträng är ett korrekt formaterat värde för den här parametern:
http://Server01:8080/WSMAN
URI:n måste vara fullständigt kvalificerad.
Type: | Uri |
Aliases: | CURI, CU |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Anger ett användarkonto som har behörighet att utföra den här åtgärden. Standard är den aktuella användaren. Ange ett användarnamn, till exempel "User01", "Domain01\User01" eller "User@Domain.com". Eller ange ett PSCredential-objekt, till exempel ett objekt som returneras av cmdleten Get-Credential
. När du skriver ett användarnamn uppmanas du att ange ett lösenord.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FilePath
Anger sökvägen till en fil som används för att skapa en hanteringsresurs. Du anger hanteringsresursen med parametern ResourceURI och parametern SelectorSet . Följande kommando använder till exempel parametern File :
Invoke-WSManAction -Action stopservice -ResourceUri wmi/cimv2/Win32_Service -SelectorSet @{Name="spooler"} -File c:\input.xml -Authentication Default
Det här kommandot anropar metoden StopService på Spooler-tjänsten med hjälp av indata från en fil. Filen, Input.xml
, innehåller följande innehåll:
<p:StopService_INPUT xmlns:p="http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_Service" />
Type: | String |
Aliases: | Path |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionSet
Skickar en uppsättning växlar till en tjänst för att ändra eller förfina typen av begäran. Dessa liknar växlar som används i kommandoradsgränssnitt eftersom de är tjänstspecifika. Valfritt antal alternativ kan anges.
I följande exempel visas den syntax som skickar värdena 1, 2 och 3 för parametrarna a, b och c:
-OptionSet @{a=1;b=2;c=3}
Type: | Hashtable |
Aliases: | os |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Anger vilken port som ska användas när klienten ansluter till WinRM-tjänsten. När transporten är HTTP är standardporten 80. När transporten är HTTPS är standardporten 443.
När du använder HTTPS som transport måste värdet för parametern ComputerName matcha serverns certifikatnamn (CN). Men om parametern SkipCNCheck anges som en del av parametern SessionOption behöver certifikatets gemensamma namn på servern inte matcha serverns värdnamn. Parametern SkipCNCheck ska endast användas för betrodda datorer.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceURI
Innehåller URI (Uniform Resource Identifier) för resursklassen eller instansen. URI:n används för att identifiera en viss typ av resurs, till exempel diskar eller processer, på en dator.
En URI består av ett prefix och en sökväg till en resurs. Exempel:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
Type: | Uri |
Aliases: | ruri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SelectorSet
Anger en uppsättning värdepar som används för att välja specifika hanteringsresursinstanser. Parametern SelectorSet används när det finns fler än en instans av resursen. Värdet för parametern SelectorSet måste vara en hash-tabell.
I följande exempel visas hur du anger ett värde för den här parametern:
-SelectorSet @{Name="WinRM";ID="yyy"}
Type: | Hashtable |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SessionOption
Definierar en uppsättning utökade alternativ för den WS-Management sessionen. Ange ett SessionOption-objekt som du skapar med hjälp av cmdleten New-WSManSessionOption
. Mer information om de tillgängliga alternativen finns i New-WSManSessionOption
.
Type: | SessionOption |
Aliases: | so |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Anger att SSL-protokollet (Secure Sockets Layer) ska användas för att upprätta en anslutning till fjärrdatorn. Som standard används inte SSL.
WS-Management krypterar allt Windows PowerShell innehåll som överförs via nätverket. Med parametern UseSSL kan du ange ytterligare skydd för HTTPS i stället för HTTP. Om SSL inte är tillgängligt på porten som används för anslutningen och du anger den här parametern misslyckas kommandot.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ValueSet
Anger en hash-tabell som hjälper dig att ändra en hanteringsresurs. Du anger hanteringsresursen med parametern ResourceURI och parametern SelectorSet . Värdet för parametern ValueSet måste vara en hash-tabell.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
Den här cmdleten returnerar den skapade WSMan-instansen som ett XmlElement-objekt .
Kommentarer
Cmdleten Set-WmiInstance
, en WMI-cmdlet (Windows Management Instrumentation), är liknande.
Set-WmiInstance
använder DCOM-anslutningen/transportlagret för att skapa eller uppdatera WMI-instanser.