Condividi tramite

  • Articolo

Disable-CsPublicProvider

 

Ultima modifica dell'argomento: 2012-03-23

Disabilita un provider pubblico configurato per l'utilizzo nell'organizzazione. Un provider pubblico è un'organizzazione che offre servizi di messaggistica istantanea, presenza e altri servizi correlati al pubblico. Microsoft Lync Server 2010 supporta tre provider pubblici, che sono configurati ma non abilitati: Yahoo!, AOL e MSN.

Sintassi

Disable-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Disable-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

La federazione è un mezzo per stabilire una relazione di trust tra due organizzazioni per agevolare la comunicazione tra i due gruppi. Una volta stabilita una federazione, gli utenti delle due organizzazioni possono inviarsi messaggi istantanei, sottoscrivere l'opzione per notifiche di presenza e comunicare tra loro in altri modi utilizzando le applicazioni SIP come Microsoft Lync 2010. Lync Server 2010 supporta tre tipi di federazione: 1) federazione diretta tra due organizzazioni; 2) federazione tra un'organizzazione e un provider pubblico; e 3) federazione tra un'organizzazione e un provider di hosting di terze parti.

Un provider pubblico è un'organizzazione che offre al pubblico servizi di comunicazione SIP (Session Initiation Protocol). Quando si stabilisce una relazione di federazione con un provider pubblico, in realtà si stabilisce una federazione con qualsiasi utente che disponga di un account ospitato da tale provider. Ad esempio, se si stabilisce una federazione con MSN, gli utenti potranno scambiare messaggi istantanei e informazioni sulla presenza con chiunque disponga di un account di messaggistica istantanea MSN.

Per poter stabilire una federazione con un provider pubblico, è necessario crearne e abilitarne uno nuovo, e il provider pubblico dovrà creare una relazione di federazione con l'utente o l'organizzazione. Quando si crea un provider pubblico, vi è la possibilità di abilitare o disabilitare la relazione federativa. Se un provider viene abilitato, gli utenti presenti nell'organizzazione potranno scambiare messaggi istantanei e informazioni sulla presenza con persone che sono titolari di account con il provider pubblico. Se un provider pubblico viene disabilitato, non sarà più possibile comunicare con i titolari di account con il provider pubblico in questione; tale condizione persisterà fino a quando il provider non verrà nuovamente abilitato. Se è necessario sospendere temporaneamente la relazione con un provider, utilizzare il cmdlet Disable-CsPublicProvider. Se si preferisce eliminare del tutto il provider, utilizzare il cmdlet Remove-CsPublicProvider.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Disable-CsPublicProvider i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsPublicProvider"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Identificatore univoco per il provider pubblico da disabilitare. l'identità in genere corrisponde al nome del sito Web che fornisce i servizi, ad esempio Yahoo!, AOL, MSN e così via.

Instance

Facoltativo

Oggetto DisplayPublicProvider

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

Force

Facoltativo

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando.

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.WritableConfig.Settings.Edge.DisplayPublicProvider. Disable-CsPublicProvider accette istanze da pipeline dell'oggetto provider pubblico.

Tipi restituiti

Nessuno. Questo cmdlet piuttosto disabilita le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Esempio

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

Disable-CsPublicProvider -Identity "MSN"

Il comando precedente disabilita il provider pubblico con valore Identity MSN. Se MSN è già disabilitato, il comando restituirà un errore.

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

Get-CsPublicProvider | Where-Object {$_.Enabled -eq $True} | Disable-CsPublicProvider

In questo esempio vengono disabilitati tutti i provider pubblici attualmente abilitati. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo i provider in cui la proprietà Enabled è uguale a True. La raccolta filtrata a sua volta viene inviata tramite pipe a Disable-CsPublicProvider, che disabilita ogni provider presente nella raccolta.

-------------------------- Esempio 3 ------------------------

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsPublicProvider

Il comando mostrato nell'esempio 3 disabilita tutti i provider pubblici attualmente abilitati e il cui livello di verifica è impostato su AlwaysVerifiable. Per eseguire questa attività, nel comando viene innanzitutto chiamato Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona i provider che soddisfano due criteri: 1) la proprietà VerificationLevel è uguale a AlwaysVerifiable e 2) la proprietà Enabled è uguale a True. l'operatore -and indica a Where-Object che gli oggetti saranno selezionati solo se soddisfano tutti i criteri specificati. La raccolta filtrata viene quindi inviata tramite pipe a Disable-CsPublicProvider, che disabilita ogni provider presente nella raccolta.