New-SmaConnection
Vytvoří instanci připojení v SMA.
Syntaxe
New-SmaConnection
-Name <String>
-ConnectionTypeName <String>
[-ConnectionFieldValues <Hashtable>]
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[<CommonParameters>] Description
Rutina New-SmaConnection vytvoří instanci připojení ve službě Service Management Automation (SMA).
Příklady
Příklad 1: Vytvoření připojení
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!"}Tento příkaz vytvoří připojení s názvem MyConnection pomocí parametrů Name, ConnectionTypeNamea ConnectionFieldValues parametry.
Opatrnost
Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Tok ověřování popsaný v tomto příkladu vyžaduje velmi vysoký stupeň důvěryhodnosti v aplikaci a nese rizika, která nejsou přítomna v jiných tocích.
Parametry
-AuthenticationType
Určuje typ ověřování. Platné hodnoty jsou:
- Základní
- Windows
Výchozí hodnota tohoto parametru je Windows. Pokud používáte základní ověřování, musíte zadat přihlašovací údaje pomocí přihlašovacích údajů parametru.
| Typ: | String |
| Přípustné hodnoty: | Basic, Windows |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ConnectionFieldValues
Určuje tabulku hash, která obsahuje páry klíč a hodnota. Klíče představují propojovací pole zadaného typu připojení. Hodnoty představují konkrétní hodnoty, které se mají uložit pro každé pole připojení instance připojení.
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ConnectionTypeName
Určuje typ připojení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Credential
Určuje objekt PSCredential pro připojení k webové službě SMA.
K získání objektu přihlašovacích údajů použijte rutinu Get-Credential.
Další informace potřebujete zadáním Get-Help Get-Credential.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Description
Určuje popis připojení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Name
Určuje název připojení.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Port
Určuje číslo portu webové služby SMA.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WebServiceEndpoint
Určuje koncový bod webové služby SMA jako adresu URL. Musíte zahrnout protokol, například http:// nebo https://.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |