Partager via

Add-SCNetworkService

  • Référence
Module:
VirtualMachineManager

Ajoute un service réseau à VMM.

Syntax

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, provisionSelfSignedCertificatesForNetworkService a la valeur $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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Certificate

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

Type:ClientCertificate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConfigurationProvider

Spécifie un objet fournisseur de configuration.

Un fournisseur de configuration est un plug-in à VMM qui convertit 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 du fabricant et du 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionString

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

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

-Description

Spécifie une description du service réseau.

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

-JobVariable

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

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

-LogicalNetworkDedicatedIP

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

Type:LogicalNetwork[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalNetworkVIP

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

Type:LogicalNetwork[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Manufacturer

Spécifie le nom de la société qui a fabriqué un appareil physique. Les valeurs valides pour ce paramètre sont :

  • Lettres (a-z)
  • Chiffres (0-9)
  • Trait de soulignement (_)
  • Trait d’union (-)
  • Point (.)
  • Apostrophe (')
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Model

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

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

-Name

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProvisionSelfSignedCertificatesForNetworkService

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-Version

Spécifie une version.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

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