Share via


New-SmaConnection

Crea un'istanza di connessione in SMA.

Sintassi

New-SmaConnection
   -Name <String>
   -ConnectionTypeName <String>
   [-ConnectionFieldValues <Hashtable>]
   [-Description <String>]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Descrizione

Il cmdlet New-SmaConnection crea un'istanza di connessione in Service Management Automation (SMA).

Esempio

Esempio 1: Creare una connessione

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!"}

Questo comando crea una connessione denominata MyConnection usando i parametri Name, ConnectionTypeName e ConnectionFieldValues .

Parametri

-AuthenticationType

Specifica il tipo di autenticazione. I valori validi sono:

  • Basic
  • Windows

Il valore predefinito per questo parametro è Windows. Se si usa l'autenticazione di base, è necessario specificare le credenziali usando il parametro Credential .

Type:String
Accepted values:Basic, Windows
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionFieldValues

Specifica una tabella hash che contiene coppie chiave e valore. Le chiavi rappresentano i campi di connessione nel tipo di connessione specificato. I valori rappresentano i valori specifici da archiviare per ogni campo di connessione per l'istanza di connessione.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionTypeName

Specifica un tipo di connessione.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifica un oggetto PSCredential per la connessione al servizio Web SMA. Per ottenere un oggetto credenziale, usare il cmdlet Get-Credential. Per ulteriori informazioni, digitare Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifica una descrizione per la connessione.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica un nome per la connessione.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Port

Specifica il numero di porta del servizio Web SMA.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WebServiceEndpoint

Specifica l'endpoint, come URL, del servizio Web SMA. È necessario includere il protocollo, ad esempio http:// o https://.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False