Freigeben über

Add-SCNetworkService

  • Referenz
Modul:
VirtualMachineManager

Fügt einen Netzwerkdienst zu VMM hinzu.

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>]

Beschreibung

Das Add-SCNetworkService-Cmdlet fügt einen Netzwerkdienst zu Virtual Machine Manager (VMM) hinzu.

Beispiele

Beispiel 1: Hinzufügen eines Netzwerkdiensts für einen Netzwerkcontroller zu 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

Der erste Befehl ruft die Ausführung als Konto ab, das von VMM zum Kommunizieren mit dem Netzwerkdienst verwendet wird. Der Befehl speichert sie in der variablen $RunAsAccount.

Der zweite Befehl ruft den Konfigurationsanbieter für den Netzwerkcontroller ab.

Der dritte Befehl erstellt eine Arrayvariable mit dem Namen $VmHostGroup. Der vierte Befehl fügt eine Hostgruppe hinzu, der der Netzwerkdienst für $VmHostGroup zugänglich ist.

Der fünfte Befehl erstellt eine Arrayvariable mit dem Namen $Certificates. Der sechste Befehl fügt das Zertifikat hinzu, das für den Netzwerkcontroller zur $Certificates verfügbar ist.

Der letzte Befehl fügt einen Netzwerkdienst für einen Netzwerkcontroller zu VMM hinzu. Der Befehl gibt die werte an, die in vorherigen Befehlen erstellt wurden. Da in diesem Beispiel selbstsignierte Zertifikate für den Netzwerkcontroller verwendet werden, hat die ProvisionSelfSignedCertificatesForNetworkService einen Wert von $True.

Parameter

-BandwidthCapacityKBps

Gibt die Bandbreitenkapazität in Kilobyte pro Sekunde (KBps) eines Netzwerkdiensts an.

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

-Certificate

Gibt ein Array von Sicherheitszertifikatobjekten an.

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

-ConfigurationProvider

Gibt ein Konfigurationsanbieterobjekt an.

Ein Konfigurationsanbieter ist ein Plug-In in VMM, das VMM PowerShell-Befehle in API-Aufrufe übersetzt, die für einen Typ des Lastenausgleichs spezifisch sind. Wenn kein Konfigurationsanbieter angegeben ist, verwendet VMM die Hersteller- und Modellinformationen, um einen verfügbaren Konfigurationsanbieter auszuwählen. Wenn kein Konfigurationsanbieter gefunden wird, wird der Lastenausgleich nicht hinzugefügt.

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

-ConnectionString

Gibt die Informationen an, die zum Herstellen einer Verbindung mit dem Erweiterungs-Manager für virtuelle Switch erforderlich sind.

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

-Description

Gibt eine Beschreibung für den Netzwerkdienst an.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-LogicalNetworkDedicatedIP

Gibt ein Array logischer Netzwerkobjekte an.

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

-LogicalNetworkVIP

Gibt ein Array logischer Netzwerkobjekte an.

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

-Manufacturer

Gibt den Namen des Unternehmens an, das ein physisches Gerät hergestellt hat. Zulässige Werte für diesen Parameter:

  • Buchstaben (a-z)
  • Zahlen (0 bis 9)
  • Unterstrich (_)
  • Bindestrich (-)
  • Punkt (.)
  • Einfaches Anführungszeichen (')
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Model

Gibt das Modell eines physischen Geräts an.

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

-Name

Gibt den Namen eines Netzwerkobjekts an.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

Gibt ein Run As-Konto an, das Anmeldeinformationen mit der Berechtigung zum Ausführen dieser Aktion enthält.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

-Version

Gibt eine Version an.

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

-VMHostGroup

Gibt ein Hostgruppenobjekt für virtuelle Maschinen oder einen Array aus Hostgruppenobjekten an.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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