Partager via

Add-SCNetworkService

  • Référence
Module:
VirtualMachineManager

Ajoute un service réseau à VMM.

Syntaxe

Add-SCNetworkService
   [-ProvisionSelfSignedCertificatesForNetworkService <Boolean>]
   [-VMMServer <ServerConnection>]
   [-ConnectionString] <String>
   -Manufacturer <String>
   -Model <String>
   [-Version <String>]
   -RunAsAccount <RunAsAccount>
   -VMHostGroup <HostGroup[]>
   -Name <String>
   [-Description <String>]
   [-BandwidthCapacityKBps <UInt64>]
   [-Certificate <ClientCertificate[]>]
   [-LogicalNetworkVIP <LogicalNetwork[]>]
   [-LogicalNetworkDedicatedIP <LogicalNetwork[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCNetworkService
   [-ProvisionSelfSignedCertificatesForNetworkService <Boolean>]
   [-VMMServer <ServerConnection>]
   [-ConnectionString] <String>
   [-Version <String>]
   -RunAsAccount <RunAsAccount>
   -VMHostGroup <HostGroup[]>
   -Name <String>
   [-Description <String>]
   -ConfigurationProvider <ConfigurationProvider>
   [-BandwidthCapacityKBps <UInt64>]
   [-Certificate <ClientCertificate[]>]
   [-LogicalNetworkVIP <LogicalNetwork[]>]
   [-LogicalNetworkDedicatedIP <LogicalNetwork[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande add-SCNetworkService ajoute un service réseau à Virtual Machine Manager (VMM).

Exemples

Exemple 1 : Ajouter un service réseau pour un contrôleur de réseau à VMM

PS C:\> $RunAsAccount = Get-SCRunAsAccount -ID "dc90a558-c402-4a70-9f6b-e50bc2fad540"
PS C:\> $ConfigurationProvider = Get-SCConfigurationProvider -Name "Microsoft Network Controller"
PS C:\> $VmHostGroup = @()
PS C:\> $VmHostGroup += Get-SCVMHostGroup -Name "All Hosts"
PS C:\> $Certificates = @()
PS C:\> $Certificates += Get-SCCertificate -ComputerName "networkcontroller.contoso.com" -TCPPort 443
PS C:\> Add-SCNetworkService -Name "NetworkController" -RunAsAccount $runAsAccount -ConfigurationProvider $ConfigurationProvider -VMHostGroup $vmHostGroup -ConnectionString "serverUrl=https://networkcontroller.contoso.com;serviceName=NC_Service" -Certificate $Certificates -ProvisionSelfSignedCertificatesForNetworkService $True

La première commande obtient le compte d’identification utilisé par VMM pour communiquer avec le service réseau. La commande la stocke dans la variable $RunAsAccount.

La deuxième commande obtient le fournisseur de configuration pour le contrôleur de réseau.

La troisième commande crée une variable de tableau nommée $VmHostGroup. La quatrième commande ajoute un groupe hôte auquel le service réseau est accessible à $VmHostGroup.

La cinquième commande crée une variable de tableau nommée $Certificates. La sixième commande ajoute le certificat disponible pour le contrôleur de réseau à $Certificates.

La commande finale ajoute le service réseau d’un contrôleur de réseau à VMM. La commande spécifie les valeurs créées dans les commandes précédentes. Étant donné que cet exemple utilise des certificats auto-signés pour le contrôleur de réseau, l'ProvisionSelfSignedCertificatesForNetworkService a une valeur de $True.

Paramètres

-BandwidthCapacityKBps

Spécifie la capacité de bande passante, en kilo-octets par seconde (KBits/s), d’un service réseau.

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

-Certificate

Spécifie un tableau d’objets de certificat de sécurité.

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

-ConfigurationProvider

Spécifie un objet fournisseur de configuration.

Un fournisseur de configuration est un plug-in à VMM qui traduit les commandes PowerShell VMM en appels d’API spécifiques à un type d’équilibreur de charge. Si aucun fournisseur de configuration n’est spécifié, VMM utilise les informations fabricant et modèle pour choisir un fournisseur de configuration disponible. Si aucun fournisseur de configuration n’est trouvé, l’équilibreur de charge n’est pas ajouté.

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

-ConnectionString

Spécifie les informations requises pour se connecter au gestionnaire d’extensions de commutateur virtuel.

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

-Description

Spécifie une description du service réseau.

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

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

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

-LogicalNetworkDedicatedIP

Spécifie un tableau d’objets réseau logiques.

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

-LogicalNetworkVIP

Spécifie un tableau d’objets réseau logiques.

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

-Manufacturer

Spécifie le nom de l’entreprise qui a fabriqué un appareil physique. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Lettres (a-z)
  • Nombres (0-9)
  • Trait de soulignement (_)
  • Trait d’union (-)
  • Point (.)
  • Guillemet unique (')
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

-Model

Spécifie le modèle d’un appareil physique.

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

-Name

Spécifie le nom d’un objet réseau.

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

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

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

-ProvisionSelfSignedCertificatesForNetworkService

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

-RunAsAccount

Spécifie un compte d’identification qui contient des informations d’identification avec l’autorisation d’effectuer cette action.

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

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-Version

Spécifie une version.

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

-VMHostGroup

Spécifie un objet de groupe hôte de machine virtuelle ou un tableau d’objets de groupe hôte.

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

-VMMServer

Spécifie un objet serveur VMM.

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