New-SmaConnection
Skapar en anslutningsinstans i SMA.
Syntax
New-SmaConnection
-Name <String>
-ConnectionTypeName <String>
[-ConnectionFieldValues <Hashtable>]
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[<CommonParameters>] Description
Cmdleten New-SmaConnection skapar en anslutningsinstans i Service Management Automation (SMA).
Exempel
Exempel 1: Skapa en anslutning
PS C:\> New-SmaConnection -WebServiceEndpoint "https://contoso.com/app01" -Name "MyConnection" -ConnectionTypeName "MyConnectionType" -Description "This is a new connection" -ConnectionFieldValues @{ "Hostname"="Computer01"; "Username"="PattiFuller"; Password="passw0rd!"}Det här kommandot skapar en anslutning med namnet MyConnection med parametrarna Name, ConnectionTypeNameoch ConnectionFieldValues.
Försiktighet
Microsoft rekommenderar att du använder det säkraste tillgängliga autentiseringsflödet. Det autentiseringsflöde som beskrivs i det här exemplet kräver en mycket hög grad av förtroende för programmet och medför risker som inte finns i andra flöden.
Parametrar
-AuthenticationType
Anger autentiseringstypen. Giltiga värden är:
- Grundläggande
- Windows
Standardvärdet för den här parametern är Windows. Om du använder Grundläggande autentisering måste du ange autentiseringsuppgifter med hjälp av parametern Credential.
| Typ: | String |
| Godkända värden: | Basic, Windows |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ConnectionFieldValues
Anger en hash-tabell som innehåller nyckel- och värdepar. Nycklarna representerar anslutningsfälten för den angivna anslutningstypen. Värdena representerar de specifika värden som ska lagras för varje anslutningsfält för anslutningsinstansen.
| Typ: | Hashtable |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ConnectionTypeName
Anger en anslutningstyp.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Credential
Anger ett PSCredential- objekt för anslutningen till SMA-webbtjänsten.
Om du vill hämta ett autentiseringsobjekt använder du cmdleten Get-Credential.
Om du vill ha mer information skriver du Get-Help Get-Credential.
| Typ: | PSCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Description
Anger en beskrivning av anslutningen.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Name
Anger ett namn på anslutningen.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Port
Anger portnumret för SMA-webbtjänsten.
| Typ: | Int32 |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-WebServiceEndpoint
Anger slutpunkten, som en URL, för SMA-webbtjänsten. Du måste inkludera protokollet, till exempel http:// eller https://.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |