Condividi tramite

  • Articolo

Remove-CsTrustedApplicationPool

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove un pool contenente i computer che ospitano applicazioni attendibili.

Sintassi

Remove-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

È consigliabile che i computer che eseguono applicazioni attendibili all'interno di una distribuzione 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, utilizzato anche per altri scopi. Questo cmdlet consente di rimuovere un pool di applicazioni attendibili esistente. Tuttavia, non è possibile rimuovere un pool di applicazioni attendibili che non dispone di un valore per il servizio di registrazione. Se al pool di applicazioni attendibili non è stato assegnato un servizio di registrazione, è necessario aggiungere un valore relativo con il cmdlet Set-CsTrustedApplicationPool e poi rimuovere il pool.

Occorre ricordare che rimuovendo il pool vengono rimossi anche tutti i computer, le applicazioni e gli endpoint applicazione associati al pool.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsTrustedApplicationPool in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) 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 "Remove-CsTrustedApplicationPool"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

Il nome di dominio completo (FQDN) o l'ID del servizio del pool da rimuovere.

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

Oggetto Microsoft.Rtc.Management.Xds.DisplayExternalServer. Consente di accettare l'input da pipeline di oggetti pool di applicazioni attendibili.

Tipi restituiti

Questo cmdlet non restituisce un valore. Rimuove un oggetto di tipo Microsoft.Rtc.Management.Xds.DisplayExternalServer.

Esempio

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

Remove-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com

Con questo esempio viene rimosso il pool con FQDN TrustPool.litwareinc.com. Viene utilizzato il parametro Identity per specificare il nome di dominio completo del pool da rimuovere. Poiché le identità sono univoche, con questo comando viene rimosso al massimo un pool.

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

Get-CsTrustedApplicationPool | Where-Object {$_.PoolFqdn -match "trust*"} | Remove-CsTrustedApplicationPool

Con questo esempio vengono rimossi tutti i pool attendibili in cui il nome di dominio completo del pool inizia con la stringa "trust". La prima parte del comando è una chiamata al cmdlet Get-CsTrustedApplicationPool, che recupera una raccolta di tutti i pool di applicazioni attendibili nell'infrastruttura di Lync Server 2010. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. Il cmdlet Where-Object controlla ogni elemento nella raccolta per vedere se PoolFqdn corrisponde alla stringa con caratteri jolly trust*. Il risultato è una raccolta di tutti i pool di applicazioni attendibili con un PoolFqdn che inizia con la stringa trust seguita da qualsiasi carattere (o caratteri). Infine, questa raccolta viene inviata tramite pipe al cmdlet Remove-CsTrustedApplicationPool, che rimuove ogni elemento nella raccolta.