Partager via


New-SmaConnection

Crée une instance de connexion dans SMA.

Syntaxe

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

Description

La cmdlet New-SmaConnection crée une instance de connexion dans Service Management Automation (SMA).

Exemples

Exemple 1 : Créer une connexion

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

Cette commande crée une connexion nommée MyConnection à l’aide de l'nom , ConnectionTypeNameet paramètres ConnectionFieldValues.

Prudence

Microsoft vous recommande d’utiliser le flux d’authentification le plus sécurisé disponible. Le flux d’authentification décrit dans cet exemple nécessite un degré de confiance très élevé dans l’application et comporte des risques qui ne sont pas présents dans d’autres flux.

Paramètres

-AuthenticationType

Spécifie le type d’authentification. Les valeurs valides sont les suivantes :

  • Basique
  • Windows

La valeur par défaut de ce paramètre est Windows. Si vous utilisez l’authentification de base, vous devez fournir des informations d’identification à l’aide du paramètre Credential.

Type:String
Valeurs acceptées:Basic, Windows
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConnectionFieldValues

Spécifie une table de hachage qui contient des paires clé et valeur. Les clés représentent les champs de connexion sur le type de connexion spécifié. Les valeurs représentent les valeurs spécifiques à stocker pour chaque champ de connexion de l’instance de connexion.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConnectionTypeName

Spécifie un type de connexion.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie un objet PSCredential pour la connexion au service web SMA. Pour obtenir un objet d’informations d’identification, utilisez l’applet de commande Get-Credential. Pour plus d’informations, tapez Get-Help Get-Credential.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description de la connexion.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un nom pour la connexion.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Port

Spécifie le numéro de port du service web SMA.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WebServiceEndpoint

Spécifie le point de terminaison, en tant qu’URL, du service web SMA. Vous devez inclure le protocole, par exemple, http:// ou https://.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False