Remove-CsPublicProvider
Ultima modifica dell'argomento: 2012-03-26
Rimuove un provider pubblico configurato per l'utilizzo nell'organizzazione. Un provider pubblico è un'organizzazione che offre al pubblico generale servizi di messaggistica istantanea, presenza e altri servizi correlati. Microsoft Lync Server 2010 supporta tre provider pubblici, che sono configurati ma non abilitati: Yahoo!, AOL e MSN.
Sintassi
Remove-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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. Quando è stata stabilita una federazione, gli utenti delle due organizzazioni possono inviarsi messaggi istantanei, sottoscrivere l'opzione di notifiche di presenza e comunicare in altri modi tra loro utilizzando le applicazioni SIP. Ad esempio, 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 fornisce servizi di comunicazione SIP al pubblico. 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. Se ad esempio 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. Se si decide in seguito di interrompere la relazione, è possibile utilizzare il cmdlet Remove-CsPublicProvider per eliminare il provider pubblico. Quando si elimina un provider pubblico, quest'ultimo viene rimosso dall'elenco dei partner federati. A quel punto, l'unico modo per ristabilire la relazione è ricreare il provider. Se si desidera sospendere temporaneamente una relazione, utilizzare invece il cmdlet Disable-CsPublicProvider. Quando un provider pubblico è disabilitato, non viene eliminato dall'elenco dei partner federati. Viene semplicemente contrassegnato come disabilitato e le comunicazioni tra la propria organizzazione e il provider vengono sospese. Per ristabilire la relazione, è possibile utilizzare Enable-CsPublicProvider per riabilitare il provider.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-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 "Remove-CsPublicProvider"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
Stringa |
Identificatore univoco per il provider pubblico da eliminare. Il valore di questo parametro in genere corrisponde al nome del sito Web che fornisce i servizi, ad esempio Yahoo!, AOL, MSN e così via. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'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. Remove-CsPublicProvider accetta le istanze da pipeline dell'oggetto provider pubblico.
Tipi restituiti
Nessuno. Il cmdlet piuttosto elimina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.
Esempio
-------------------------- Esempio 1 ------------------------
Remove-CsPublicProvider -Identity "MSN"
Il comando precedente elimina il provider pubblico con valore Identity MSN. Al completamento del comando, MSN non sarà più visualizzato nell'elenco dei provider pubblici configurati. A quel punto, l'unico modo per ristabilire la federazione con MSN è ricreare il provider.
-------------------------- Esempio 2 ------------------------
Get-CsPublicProvider | Remove-CsPublicProvider
Nell'esempio 2 vengono eliminati tutti i provider pubblici configurati per l'utilizzo nell'organizzazione. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici attualmente configurati per l'utilizzo. La raccolta viene quindi inviata tramite pipe a Remove-CsPublicProvider, che a sua volta elimina ogni provider contenuto nella raccolta.
-------------------------- Esempio 3 ------------------------
Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False} | Remove-CsPublicProvider
Nell'esempio 3, tutti i provider pubblici attualmente disabilitati vengono rimossi dal set dei provider pubblici configurati. Per eseguire questa operazione, nel comando viene innanzitutto utilizzato Get-CsPublicProvider per restituire una raccolta di tutti i provider pubblici attualmente configurati per l'utilizzo. La raccolta viene inviata tramite pipe al cmdlet Where-Object, che seleziona solo i provider con proprietà Enabled uguale a False. La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsPublicProvider, che elimina tutti gli elementi della raccolta.
Vedere anche
Ulteriori risorse
Disable-CsPublicProvider
Enable-CsPublicProvider
Get-CsPublicProvider
New-CsPublicProvider
Set-CsPublicProvider