Freigeben über

Add-SCNetworkService

Modul:
VirtualMachineManager Module

Fügt VMM einen Netzwerkdienst hinzu.

Syntax

ByModel (Standardwert) 

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

ByProvider 

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

Beschreibung

Das Cmdlet Add-SCNetworkService fügt Virtual Machine Manager (VMM) einen Netzwerkdienst 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

Mit dem ersten Befehl wird das ausführende Konto abgerufen, das von VMM für die Kommunikation mit dem Netzwerkdienst verwendet wird. Der Befehl speichert sie in der Variablen $RunAsAccount.

Mit dem zweiten Befehl wird der Konfigurationsanbieter für den Netzwerkcontroller abgerufen.

Mit dem dritten Befehl wird eine Array-Variable mit dem Namen $VmHostGroup erstellt. Mit dem vierten Befehl wird eine Hostgruppe hinzugefügt, auf die der Netzwerkdienst für $VmHostGroup zugreifen kann.

Mit dem fünften Befehl wird eine Array-Variable mit dem Namen $Certificates erstellt. Mit dem sechsten Befehl wird $Certificates das für den Netzwerkcontroller verfügbare Zertifikat hinzugefügt.

Mit dem letzten Befehl wird VMM der Netzwerkdienst für einen Netzwerkcontroller hinzugefügt. Der Befehl gibt die Werte an, die in den vorherigen Befehlen erstellt wurden. Da in diesem Beispiel selbstsignierte Zertifikate für den Netzwerkcontroller verwendet werden, hat ProvisionSelfSignedCertificatesForNetworkService den Wert $True.

Parameter

-BandwidthCapacityKBps

Gibt die Bandbreitenkapazität eines Netzwerkdienstes in Kilobyte pro Sekunde (KBit/s) an.

Parametereigenschaften

Typ:UInt64
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Certificate

Gibt ein Array von Sicherheitszertifikatobjekten an.

Parametereigenschaften

Typ:

ClientCertificate[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConfigurationProvider

Gibt ein Konfigurationsanbieterobjekt an.

Ein Konfigurationsanbieter ist ein Plug-In für VMM, das VMM PowerShell-Befehle in API-Aufrufe übersetzt, die für einen bestimmten Lastenausgleichstyp 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 Load Balancer nicht hinzugefügt.

Parametereigenschaften

Typ:ConfigurationProvider
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByProvider
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConnectionString

Gibt die Informationen an, die für die Verbindung mit dem Erweiterungs-Manager für virtuelle Switches erforderlich sind.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für den Netzwerkdienst an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LogicalNetworkDedicatedIP

Gibt ein Array logischer Netzwerkobjekte an.

Parametereigenschaften

Typ:

LogicalNetwork[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LogicalNetworkVIP

Gibt ein Array logischer Netzwerkobjekte an.

Parametereigenschaften

Typ:

LogicalNetwork[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Manufacturer

Gibt den Namen des Unternehmens an, das ein physisches Gerät hergestellt hat. Die zulässigen Werte für diesen Parameter sind:

  • Buchstaben (a-z)
  • Zahlen (0-9)
  • Unterstrich (_)
  • Bindestrich (-)
  • Punkt (.)
  • Einfaches Anführungszeichen (')

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByModel
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Model

Gibt das Modell eines physischen Geräts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByModel
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen eines Netzwerkobjekts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ProvisionSelfSignedCertificatesForNetworkService

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsAccount

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

Parametereigenschaften

Typ:RunAsAccount
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Version

Gibt eine Version an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMHostGroup

Gibt ein Hostgruppenobjekt einer virtuellen Maschine oder ein Array von Hostgruppenobjekten an.

Parametereigenschaften

Typ:

HostGroup[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.