• Articolo

New-CsTrustedApplicationPool

 

Ultima modifica dell'argomento: 2012-03-27

Crea un nuovo pool per contenere i computer che ospitano applicazioni attendibili.

Sintassi

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

Descrizione dettagliata

È consigliabile che i computer che eseguono applicazioni attendibili all'interno di una distribuzione di Microsoft Lync Server 2010 vengano aggiunti a un pool distinto, destinato unicamente a questo tipo di applicazioni. È tuttavia possibile aggiungere i computer con applicazioni attendibili a un pool esistente già utilizzato anche per altri scopi. Se il pool è già presente nella topologia, questo cmdlet crea il servizio esterno associato a tale pool (con un ruolo del servizio ExternalServer). Se il pool non esiste, questo cmdlet crea il pool e il servizio corrispondente. È possibile visualizzare un elenco di tutti i pool esistenti chiamando il cmdlet Get-CsPool.

Se si crea un nuovo pool di applicazioni attendibili, un nuovo servizio esterno, si crea anche un nuovo computer con applicazioni attendibili assegnato a tale pool. Per impostazione predefinita al computer viene assegnato lo stesso nome di dominio completo (FQDN) del pool. Tuttavia, è possibile specificare un proprio valore per il nome FQDN, utilizzando il parametro ComputerFqdn di questo cmdlet. Se si desidera aggiungere più computer al pool, è necessario specificare un valore ComputerFqdn differente rispetto al nome FQDN del pool. Per aggiungere più computer al pool, chiamare il cmdlet New-CsTrustedApplicationComputer.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsTrustedApplicationPool i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

FQDN del nuovo pool. Si noti che, sebbene il valore Identity per la creazione di un pool sia il pool FQDN, il valore che verrà archiviato come Identity per il nuovo pool è un ID servizio del pool che viene generato automaticamente. l'identità immessa qui viene salvata come PoolFqdn.

AppSharingPortCount

Facoltativo

Uint16

Il numero di porte disponibili nell'intervallo delle porte per le connessioni di condivisione delle applicazioni.

Valore predefinito: 0

AppSharingPortStart

Facoltativo

UInt16

Il numero della prima porta, nell'intervallo delle porte, disponibile per le connessioni di condivisione delle applicazioni.

AudioPortCount

Facoltativo

UInt16

Il numero di porte disponibili nell'intervallo delle porte per le connessioni audio.

Valore predefinito: 0

AudioPortStart

Facoltativo

UInt16

Il numero della prima porta, nell'intervallo delle porte, disponibile per le connessioni audio.

ComputerFqdn

Facoltativo

FQDN

Se si crea un pool di applicazioni attendibili, viene creato automaticamente un computer con applicazioni attendibili che fa parte di tale pool. Per impostazione predefinita al computer viene assegnato lo stesso FQDN del pool. Immettere un valore in questo parametro, per specificare un nome FQDN per il computer distinto dall'FQDN del pool. Se si desidera aggiungere più computer al pool, è necessario immettere un valore per questo parametro, differente rispetto al nome FQDN del pool.

OutboundOnly

Facoltativo

Booleano

Specifica se a un'applicazione attendibile è consentito avviare la connessione a un server del pool. Impostare il valore su True, se si desidera che tutte le connessioni vengano avviate dal server anziché dall'applicazione.

Valore predefinito: False

Registrar

Facoltativo

Stringa

ID servizio o FQDN del servizio di registrazione del pool.

Sebbene questo parametro sia facoltativo, nel caso si tenti di creare un nuovo endpoint applicazioni attendibili tramite il cmdlet New-CsTrustedApplicationEndpoint e di assegnarlo a un pool che non dipende da un servizio di registrazione, verrà restituito un messaggio di errore e l'endpoint non verrà creato. Inoltre, non è possibile rimuovere un pool di applicazioni attendibili che non è associato a un servizio Registrar.

RequiresReplication

Facoltativo

Booleano

Determina se per il pool è richiesta la replica. Impostare il valore su False, se non è richiesta la replica. Il parametro in genere viene impostato su False per Microsoft Outlook Web Access e per le applicazioni di cui viene eseguito manualmente il provisioning.

Valore predefinito: True

Site

Facoltativo

Stringa

l'ID del sito che ospita il pool. Chiamare il cmdlet Get-CsSite per recuperare la proprietà SiteId di un sito. Tenere presente che è necessario utilizzare la proprietà SiteId anziché il valore Identity del sito. Si noti inoltre che il valore SiteId non deve essere preceduto dalla stringa "site:". È necessario immettere solo il valore SiteId. Benché inoltre venga immesso il valore SiteId recuperato da Get-CsSite, la proprietà SiteId del nuovo pool di applicazioni attendibili conterrà il valore Identity del sito. Se ad esempio il valore SiteId del sito è Main e il valore Identity del sito è site:Redmond1, sarà necessario immettere -Site Main nella chiamata a New-CsTrustedApplicationPool, ma in una chiamata successiva a Get-CsTrustedApplicationPool il valore di SiteId sarà site:Redmond1.

Se il pool specificato nell'identità esiste già, non è necessario specificare una proprietà Site. Se il pool non esiste, questo parametro è obbligatorio.

ThrottleAsServer

Facoltativo

Booleano

Impostare il parametro su False per limitare le connessioni fra i server all'interno del pool e le applicazioni attendibili come client. Questa impostazione impone maggiori limitazioni sulla connessione rispetto al valore predefinito True, che limita le connessioni come server. Limitare una connessione significa imporre restrizioni per il numero di transazioni che è possibile eseguire contemporaneamente.

Valore predefinito: True

TreatAsAuthenticated

Facoltativo

Booleano

Determina se è richiesta l'autenticazione per le applicazioni attendibili che si collegano ai server presenti nel pool. Impostare questo parametro su False, se si desidera richiedere l'autenticazione delle applicazioni attendibili. Il valore predefinito True consente la connessione delle applicazioni attendibili, benché solo se già autenticate.

Valore predefinito: True

VideoPortCount

Facoltativo

UInt16

Il numero di porte disponibili nell'intervallo delle porte per le connessioni video.

Valore predefinito: 0

VideoPortStart

Facoltativo

Uint16

Il numero della prima porta, nell'intervallo delle porte, disponibile per le connessioni video.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno.

Tipi restituiti

Crea un oggetto di tipo Microsoft.Rtc.Management.Xds.DisplayExternalServer.

Esempio

-------------------------- Esempio 1 ------------------------

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

In questo esempio viene creato un nuovo pool con FQDN TrustPool.litwareinc.com. Per specificare il nuovo nome FQDN, viene utilizzato il parametro Identity. Viene utilizzato il parametro Registrar con il valore pool0.litwareinc.com, per associare il nuovo pool con servizio di registrazione a tale FQDN. Infine, viene utilizzato il parametro Site con valore Redmond, per indicare che il pool fa parte del sito Redmond.

Si noti che il valore Site corrisponde al valore SiteId, che può essere recuperato chiamando Get-CsSite. Il valore Identity del sito tuttavia verrà archiviato con il nuovo pool di applicazioni attendibili. Se ad esempio il valore Identity di un sito è site:Redmond1 e il valore SiteId è NA, sarà necessario utilizzare NA come valore del parametro Site nella chiamata a New-CsTrustedApplicationPool. Se tuttavia in un secondo momento si desidera trovare tutti i pool di applicazioni attendibili per il sito NA, verrà utilizzato il valore Identity nella clausola where, come indicato di seguito:

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

-------------------------- Esempio 2 ------------------------

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

l'esempio 2 è identico all'esempio 1, con la differenza che anziché specificare un nome di dominio completo (FQDN) per il servizio di registrazione, viene utilizzato l'ID servizio Registrar:redmond.litwareinc.com. È stato specificato inoltre un valore per il parametro ComputerFqdn. Quando si crea un pool, all'interno del pool viene creato anche un computer. Per impostazione predefinita al computer viene assegnato lo stesso FQDN del pool. Per il computer di questo pool è stato specificato un FQDN differente, AppServer.litwareinc.com.