• Artikel

New-CsTrustedApplicationPool

 

Letztes Änderungsdatum des Themas: 2012-03-27

Erstellt einen neuen Pool für Computer, auf denen vertrauenswürdige Anwendungen gehostet werden.

Syntax

New-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-ComputerFqdn <Fqdn>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-OutboundOnly <$true | $false>] [-Registrar <String>] [-RequiresReplication <$true | $false>] [-Site <String>] [-ThrottleAsServer <$true | $false>] [-TreatAsAuthenticated <$true | $false>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Es wird empfohlen, Computer, auf denen innerhalb einer Microsoft Lync Server 2010-Bereitstellung vertrauenswürdige Anwendungen ausgeführt werden, einem separaten Pool nur für vertrauenswürdige Anwendungen hinzuzufügen. Sie können Computer mit vertrauenswürdigen Anwendungen auch einem vorhandenen Pool hinzufügen, der bereits für andere Zwecke genutzt wird. Wenn der Pool bereits als Teil der Topologie verwendet wird, erstellt dieses Cmdlet den diesem Pool zugeordneten externen Dienst mit der Dienstrolle "ExternalServer". Wenn der Pool nicht vorhanden ist, erstellt dieses Cmdlet den Pool und den entsprechenden Dienst. (Sie können eine Liste aller vorhandenen Pools durch Aufrufen des Cmdlets Get-CsPool abrufen.)

Im Zuge der Erstellung eines neuen Pools mit vertrauenswürdigen Anwendungen wird auch ein neuer Computer mit vertrauenswürdigen Anwendungen erstellt und dem Pool zugewiesen. Dem Computer wird standardmäßig derselbe vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) wie dem Pool zugewiesen. Sie können jedoch mit dem Parameter "ComputerFqdn" dieses Cmdlets auch einen eigenen Wert für den vollqualifizierten Domänennamen angeben. Wenn Sie planen, dem Pool weitere Computer hinzuzufügen, muss sich der Wert für "ComputerFqdn" vom vollqualifizierten Domänennamen des Pools unterscheiden. Weitere Computer fügen Sie dem Pool durch Aufrufen des Cmdlets New-CsTrustedApplicationComputer hinzu.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsTrustedApplicationPool lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplicationPool"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Der vollqualifizierte Domänenname (FQDN) des Pools. Beachten Sie, dass während der Identitätswert für das Erstellen eines Pools der FQDN des Pools ist, es sich bei dem gespeicherten Identitätswert des neuen Pools eigentlich um eine automatisch generierte Dienst-ID des Pools handelt. Der hier eingegebene Identitätswert wird als "PoolFqdn" gespeichert.

AppSharingPortCount

Optional

Uint16

Die Anzahl von Ports in dem für Verbindungen für die Anwendungsfreigabe verfügbaren Portbereich.

Standard: 0

AppSharingPortStart

Optional

UInt16

Die Nummer des ersten Ports in dem für Verbindungen für die Anwendungsfreigabe verfügbaren Portbereich.

AudioPortCount

Optional

UInt16

Die Anzahl von Ports in dem für Audioverbindungen verfügbaren Portbereich.

Standard: 0

AudioPortStart

Optional

UInt16

Die Nummer des ersten Ports in dem für Audioverbindungen verfügbaren Portbereich.

ComputerFqdn

Optional

FQDN

Bei der Erstellung eines Pools mit vertrauenswürdigen Anwendungen wird automatisch ein Computer mit vertrauenswürdigen Anwendungen erstellt, der Teil dieses Pools ist. Der Computer erhält standardmäßig denselben FQDN wie der Pool. Geben Sie in diesen Parameter einen Wert ein, um einen FQDN für den Computer anzugeben, der vom FQDN des Pools abweicht. Wenn Sie planen, dem Pool weitere Computer hinzuzufügen, müssen Sie für diesen Parameter einen Wert eingeben, der sich vom vollqualifizierten Domänennamen des Pools unterscheidet.

OutboundOnly

Optional

Boolescher Wert

Legt fest, ob eine vertrauenswürdige Anwendung eine Verbindung mit einem Server im Pool initiieren kann. Legen Sie diesen Wert auf "True" fest, wenn alle Verbindungen vom Server und nicht von der Anwendung initiiert werden sollen.

Standard: False

Registrar

Optional

Zeichenfolge

Die Dienst-ID oder der FQDN des Registrierungsdiensts für den Pool.

Dieser Parameter ist zwar optional, wenn Sie jedoch versuchen, mit dem Cmdlet New-CsTrustedApplicationEndpoint einen neuen Endpunkt für vertrauenswürdige Anwendungen zu erstellen und den Endpunkt einem Pool zuzuweisen, der keine Zuweisung zu einer Registrierung aufweist, erhalten Sie eine Fehlermeldung, und der Endpunkt wird nicht erstellt. Darüber hinaus ist das Entfernen von Pools mit vertrauenswürdigen Anwendungen, denen keine Registrierung zugeordnet ist, nicht möglich.

RequiresReplication

Optional

Boolescher Wert

Legt fest, ob für diesen Pool eine Replikation erforderlich ist. Legen Sie diesen Wert auf "False" fest, wenn keine Replikation erforderlich ist. Dieser Parameter wird für Microsoft Outlook Web Access und für manuell bereitgestellte Anwendungen im Allgemeinen auf "False" festgelegt.

Standard: True

Site

Optional

Zeichenfolge

Die ID des Standorts, an dem sich dieser Pool befindet. Rufen Sie das Cmdlet Get-CsSite auf, um die Eigenschaft "SiteId" eines Standorts abzurufen. Beachten Sie, dass Sie anstelle von "Identity" die Eigenschaft "SiteId" für den Standort verwenden müssen. Achten Sie ferner darauf, dass der Wert für "SiteId" nicht mit der Zeichenfolge "site:" beginnen darf, verwenden Sie nur die Standort-ID. Beachten Sie außerdem, dass die Eigenschaft "SiteId" des neuen Pools für vertrauenswürdige Anwendungen trotz Angabe des mit dem Cmdlet Get-CsSite abgerufenen Werts für "SiteId" den Wert "Identity" des Standorts enthält. Wenn beispielsweise der Wert von "SiteId" für den Standort "Main" lautet und der Wert für "Identity" als "site:Redmond1" angegeben ist, müssen Sie beim Aufruf des Cmdlets New-CsTrustedApplicationPool "-Site Main" eingeben. Ein nachfolgender Aufruf von Get-CsTrustedApplicationPool zeigt den Wert von "SiteId" jedoch als "site:Redmond1" an.

Wenn der für "Identity" angegebene Pool bereits vorhanden ist, müssen Sie keinen Standort angeben. Wenn der Pool nicht vorhanden ist, ist dieser Parameter erforderlich.

ThrottleAsServer

Optional

Boolescher Wert

Legen Sie diesen Parameter auf "False" fest, um Verbindungen zwischen den Servern innerhalb des Pools und den vertrauenswürdigen Anwendungen als Clients einzuschränken. Dadurch werden die Verbindungen stärker eingeschränkt als mit dem Standardwert "True", bei dem Verbindungen als Server eingeschränkt werden. Durch die Einschränkung einer Verbindung wird die Anzahl von Transaktionen beschränkt, die gleichzeitig ausgeführt werden können.

Standard: True

TreatAsAuthenticated

Optional

Boolescher Wert

Legt fest, ob für vertrauenswürdige Anwendungen, die eine Verbindung mit den Servern im Pool herstellen, eine Authentifizierung erforderlich ist. Legen Sie diesen Parameter auf "False" fest, wenn die vertrauenswürdigen Anwendungen authentifiziert werden sollen. Bei Festlegung des Standardwerts "True" können die vertrauenswürdigen Anwendungen unter der Annahme, dass sie bereits authentifiziert wurden, eine Verbindung herstellen.

Standard: True

VideoPortCount

Optional

UInt16

Die Anzahl von Ports in dem für Videoverbindungen verfügbaren Portbereich.

Standard: 0

VideoPortStart

Optional

Uint16

Die Nummer des ersten Ports in dem für Videoverbindungen verfügbaren Portbereich.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.Xds.DisplayExternalServer".

Beispiel

-------------------------- Beispiel 1 ------------------------

New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar pool0.litwareinc.com -Site Redmond

In diesem Beispiel wird ein neuer Pool mit dem FQDN "TrustPool.litwareinc.com" erstellt. Für das Angeben des neuen FQDN wird der Parameter "Identity" verwendet. Für den Paramter "Registrar" wird der Wert "pool0.litwareinc.com" angegeben, um den neuen Pool dem Registrierungsdienst an diesem FQDN zuzuordnen. Abschließend wird für den Parameter "Site" der Wert "Redmond" verwendet, womit angegeben wird, dass dieser Pool Teil des Standorts "Redmond" sein wird.

Beachten Sie, dass der Wert für "Site" dem von "SiteId" entspricht (dieser Wert kann durch Aufrufen von Get-CsSite abgerufen werden). Es wird jedoch der Wert von "Identity" für den Standort im neuen Pool für vertrauenswürdige Anwendungen gespeichert. Wenn "Identity" für einen Standort beispielsweise als "site:Redmond1" und "SiteId" als "NA" festgelegt ist, müssen Sie beim Aufruf von New-CsTrustedApplicationPool "NA" als Wert für den Parameter "Site" einschließen. Wenn Sie später jedoch alle Pools für vertrauenswürdige Anwendungen für den Standort "NA" ermitteln möchten, verwenden Sie den Wert von "Identity" in der Where-Klausel:

Get-CsTrustedApplicationPool | Where-Object {$_.SiteId –eq "site:Redmond1"}

-------------------------- Beispiel 2 ------------------------

New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar Registrar:redmond.litwareinc.com -Site Redmond -ComputerFqdn AppServer.litwareinc.com

Beispiel 2 ist mit Beispiel 1 identisch. Hier wird jedoch keine FQDN für den Registrierungsdienst angegeben, sondern die Dienst-ID "Registrar:redmond.litwareinc.com" verwendet. Darüber hinaus wird ein Wert für den Parameter "ComputerFqdn" angegeben. Wenn ein Pool erstellt wird, wird auch ein Computer in diesem Pool erstellt. Der Computer erhält standardmäßig denselben FQDN wie der Pool. Hier wurde für den Computer in diesem Pool ein abweichender FQDN angegeben: AppServer.litwareinc.com.