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.
Vedere anche
Ulteriori risorse
Remove-CsTrustedApplicationPool
Set-CsTrustedApplicationPool
Get-CsTrustedApplicationPool
New-CsTrustedApplicationComputer
Get-CsSite