Get-CsPstnUsage
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni sui record di utilizzo della rete PSTN (Public Switched Telephone Network) usati nell'organizzazione.
Sintassi
Get-CsPstnUsage [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPstnUsage [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Gli utilizzi della rete PSTN sono valori stringa utilizzati per l'autorizzazione delle chiamate. Un utilizzo delle rete PSTN collega un criterio vocale a una route. Il cmdlet Get-CsPstnUsage consente di recuperare l'elenco di tutti gli utilizzi della rete PSTN disponibili nell'organizzazione.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsPstnUsage può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPstnUsage"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsIdentity |
Il livello di applicazione di queste impostazioni. L'unica identità che può essere applicata agli utilizzi della rete PSTN è Global. |
Filter |
Facoltativo |
Stringa |
Il parametro Filter consente di recuperare solo gli utilizzi della rete PSTN con un valore Identity che corrisponde a una determinata stringa di caratteri jolly. Tuttavia, l'unico valore Identity disponibile per gli utilizzi della rete PSTN è Global e di conseguenza questo parametro non è utilizzato con questo cmdlet. |
LocalStore |
Facoltativo |
Parametro opzionale |
Consente di ottenere le informazioni sugli utilizzi della rete PSTN dall'archivio dati locale piuttosto che da archivio di gestione centrale. |
Tipi di input
Nessuno.
Tipi restituiti
Get-CsPstnUsage restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PSTNUsages.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsPstnUsage
Questo comando restituisce l'elenco degli utilizzi globali della rete PSTN disponibili nell'organizzazione.
-------------------------- Esempio 2 --------------------------
(Get-CsPstnUsage).Usage
In questo esempio, il comando restituisce un elenco di tutti gli utilizzi della rete PSTN definiti, con un utilizzo su ogni riga dell'output. L'utilizzo del cmdlet Get-CsPstnUsage restituisce il valore Identity e l'elenco degli utilizzi. Se l'elenco degli utilizzi contiene più di tre o quattro voci, l'elenco verrà abbreviato nell'output:
Usage : {Internal, Local, Long Distance, International...}
Utilizzare il comando di questo esempio per visualizzare solo un elenco di utilizzi. L'output sarà simile a questo:
Internal
Local
Long Distance
International
Restricted
-------------------------- Esempio 3 --------------------------
(Get-CsPstnUsage).Usage | ForEach-Object {if ($_ -like "*tern*") {$_}}
Questo comando restituisce tutti i nomi di utilizzo della rete PSTN che contengono la stringa "tern" all'interno del nome. Ad esempio, questo comando restituirà l'indicazione "Internal" e "International", ma non "Local" o "Long Distance".
La prima parte di questo comando è il cmdlet Get-CsPstnUsage tra parentesi e ciò significa che come prima cosa verranno recuperati tutti gli utilizzi della rete PSTN. La proprietà .Usage restituisce solo le informazioni di utilizzo per gli utilizzi della rete PSTN, ma non il valore Identity. L'elenco degli utilizzi è quindi inviato tramite pipe al cmdlet ForEach-Object che legge le stringhe di utilizzo una alla volta. L'istruzione If confronta la stringa di utilizzo corrente alla stringa "*tern*" (i simboli * sono caratteri jolly) e visualizza le occorrenze che corrispondono a questo motivo.