Partager via


Get-SilUalAccess

Get-SilUalAccess

Displays the total number of unique client device requests and client user requests of the server from two days prior. Windows Server 2012 R2 with KB3000850 applied. For more information, see https://support.microsoft.com/kb/3000850.

Syntaxe

Parameter Set: Query (cdxml)
Get-SilUalAccess [[-RoleGuid] <String[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-RoleName <String[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Description détaillée

The Get-SilUalAccess cmdlet displays the total number of unique client device requests and the total number of client user requests for server roles or software products. You can specify the RoleName parameter and RoleGuid parameter to filter the client device requests and client user requests of the server that the cmdlet displays.

The cmdlet returns totals of client requests for a server role or software product that uses the User Access Logging framework to capture client requests. The cmdlet returns totals for one calendar day, two days prior to when the cmdlet is run.

Paramètres

-AsJob

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-CimSession<CimSession[]>

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, comme la sortie d’une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.

Alias

Session

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-RoleGuid<String[]>

Specifies an array of GUIDs of server roles or software products installed on the server.

Alias

none

Obligatoire ?

false

Position ?

1

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByPropertyName)

Accepter les caractères génériques ?

false

-RoleName<String[]>

Specifies an array of names of server roles or software products installed on the server.

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByPropertyName)

Accepter les caractères génériques ?

false

-ThrottleLimit<Int32>

Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter cette applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell ® calcule une limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limitation s’applique seulement à l’applet de commande actuelle, et non pas à la session ni à l’ordinateur.

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

  • Microsoft.Management.Infrastructure.CimInstance#root/InventoryLogging/MsftSil_UalAccess

    This cmdlet returns an object that encapsulates the unique role access information for a device or user. That object includes the following properties:

    -- ProductName (System.String)
    -- RoleGuid (System.String)
    -- RoleName (System.String)
    -- SampleDate (System.DateTime)
    -- UniqueDeviceAccessCount (System.UInt32)
    -- UniqueUserAccessCount (System.UInt32)

Exemples

Example 1: Display the total number of client requests of the server

This command displays the total number of unique client requests of the server for the day, two days prior from when the cmdlet is run.

PS C:\> Get-SilUalAccess

Example 2: Display UAL data for a specified server role

This command displays a filtered list of UAL data for only the server role specified.

PS C:\> Get-SilUalAccess –RoleName "Print and Document Services"

Rubriques connexes

Get-SilSoftware

Get-SilComputer

Get-SilData

Get-SilLogging

Get-SilWindowsUpdate