Capitolo 3 - Individuazione di oggetti, proprietà e metodiChapter 3 - Discovering objects, properties, and methods

La mia prima esperienza con un computer è stata con un Commodore 64, ma il mio primo computer moderno è stato un 286 IBM compatibile a 12 MHz con 1 MB di memoria, un disco rigido da 40 MB e un'unità floppy disk da 5,25 pollici con monitor CGA e sistema operativo Microsoft DOS 3.3.My first introduction to computers was a Commodore 64, but my first modern computer was a 286 12-Mhz IBM clone with 1 megabyte of memory, a 40-megabyte hard drive, and one 5-1/4 inch floppy disk drive with a CGA monitor running Microsoft DOS 3.3.

Molti professionisti dell'IT come me conoscono la riga di comando, ma quando si parla di oggetti, proprietà e metodi sbarrano gli occhi e dicono: "Non sono uno sviluppatore".Many IT Pros, like myself, are no stranger to the command line, but when the subject of objects, properties, and methods comes up, they get the deer in the headlights look and say, "I'm not a developer." Sapete una cosa?Guess what? Non è necessario essere uno sviluppatore per usare correttamente PowerShell.You don't have to be a developer to be successful with PowerShell. Non bisogna perdersi nella terminologia.Don't get bogged down in the terminology. Non tutto avrà un senso all'inizio, ma dopo una piccola esperienza pratica arriveranno i momenti di "illuminazione".Not everything may make sense initially, but after a little hands-on experience you'll start to have those "light bulb" moments. A-ha!"Aha! Ecco di cosa parlava il libro".So that's what the book was talking about."

Provare gli esempi nel proprio computer per acquisire un po' di questa esperienza pratica.Be sure to try the examples on your computer to gain some of that hands-on experience.

RequisitiRequirements

Il modulo Active Directory PowerShell è necessario per alcuni degli esempi illustrati in questo capitolo.The Active Directory PowerShell module is required by some of the examples shown in this chapter. Fa parte di Strumenti di amministrazione remota del server (RSAT) per Windows.The module is part of the Remote Server Administration Tools (RSAT) for Windows. Per la build 1809 o successiva di Windows, Strumenti di amministrazione remota del server è installato come funzionalità di Windows.For the 1809 (or higher) build of Windows, the RSAT tools are installed as a Windows feature.

Get-MemberGet-Member

Get-Member consente di individuare gli oggetti, le proprietà e i metodi disponibili per i comandi.Get-Member helps you discover what objects, properties, and methods are available for commands. Tutti i comandi che producono un output basato su oggetti possono essere inviati tramite pipe a Get-Member.Any command that produces object-based output can be piped to Get-Member. Una proprietà è una caratteristica di un elemento.A property is a characteristic about an item. La patente di guida ha una proprietà denominata Colore degli occhi e i valori più comuni per tale proprietà sono blu e marrone.Your drivers license has a property called eye color and the most common values for that property are blue and brown. Un metodo è un'azione che può essere eseguita su un elemento.A method is an action that can be taken on an item. Nell'esempio della patente di guida, uno dei metodi è "Revoca" perché il prefetto può revocare la patente di guida.In staying with the drivers license example, one of the methods is "Revoke" because the department of motor vehicles can revoke your drivers license.

ProprietàProperties

Nell'esempio seguente recupererò informazioni sul servizio Ora di Windows in esecuzione nel computer.In the following example, I'll retrieve information about the Windows Time service running on my computer.

Get-Service -Name w32time
Status   Name               DisplayName
------   ----               -----------
Running  w32time            Windows Time

Status, Name e DisplayName sono esempi di proprietà, come mostrato nel set di risultati precedente.Status, Name, and DisplayName are examples of properties as shown in the previous set of results. Il valore della proprietà Status è Running, il valore della proprietà Name è w32time e il valore di DisplayName è Windows Time.The value for the Status property is Running, the value for the Name property is w32time, and the value for DisplayName is Windows Time.

A questo punto invierò lo stesso comando tramite pipe a Get-Member:Now I'll pipe that same command to Get-Member:

Get-Service -Name w32time | Get-Member
   TypeName: System.ServiceProcess.ServiceController

Name                      MemberType    Definition
----                      ----------    ----------
Name                      AliasProperty Name = ServiceName
RequiredServices          AliasProperty RequiredServices = ServicesDependedOn
Disposed                  Event         System.EventHandler Disposed(System.Object, Sy...
Close                     Method        void Close()
Continue                  Method        void Continue()
CreateObjRef              Method        System.Runtime.Remoting.ObjRef CreateObjRef(ty...
Dispose                   Method        void Dispose(), void IDisposable.Dispose()
Equals                    Method        bool Equals(System.Object obj)
ExecuteCommand            Method        void ExecuteCommand(int command)
GetHashCode               Method        int GetHashCode()
GetLifetimeService        Method        System.Object GetLifetimeService()
GetType                   Method        type GetType()
InitializeLifetimeService Method        System.Object InitializeLifetimeService()
Pause                     Method        void Pause()
Refresh                   Method        void Refresh()
Start                     Method        void Start(), void Start(string[] args)
Stop                      Method        void Stop()
WaitForStatus             Method        void WaitForStatus(System.ServiceProcess.Servi...
CanPauseAndContinue       Property      bool CanPauseAndContinue {get;}
CanShutdown               Property      bool CanShutdown {get;}
CanStop                   Property      bool CanStop {get;}
Container                 Property      System.ComponentModel.IContainer Container {get;}
DependentServices         Property      System.ServiceProcess.ServiceController[] Depe...
DisplayName               Property      string DisplayName {get;set;}
MachineName               Property      string MachineName {get;set;}
ServiceHandle             Property      System.Runtime.InteropServices.SafeHandle Serv...
ServiceName               Property      string ServiceName {get;set;}
ServicesDependedOn        Property      System.ServiceProcess.ServiceController[] Serv...
ServiceType               Property      System.ServiceProcess.ServiceType ServiceType ...
Site                      Property      System.ComponentModel.ISite Site {get;set;}
StartType                 Property      System.ServiceProcess.ServiceStartMode StartTy...
Status                    Property      System.ServiceProcess.ServiceControllerStatus ...
ToString                  ScriptMethod  System.Object ToString();

La prima riga dei risultati nell'esempio precedente contiene un'informazione molto importante.The first line of the results in the previous example contains one piece of very important information. TypeName indica il tipo di oggetto restituito.TypeName tells you what type of object was returned. In questo esempio è stato restituito un oggetto System.ServiceProcess.ServiceController.In this example, a System.ServiceProcess.ServiceController object was returned. Questo oggetto viene spesso abbreviato con la parte di TypeName subito dopo l'ultimo punto, in questo esempio ServiceController.This is often abbreviated as the portion of the TypeName just after the last period; ServiceController in this example.

Quando si conosce il tipo di oggetto prodotto da un comando, è possibile usare queste informazioni per trovare i comandi che accettano quel tipo di oggetto come input.Once you know what type of object a command produces, you can use this information to find commands that accept that type of object as input.

Get-Command -ParameterType ServiceController
CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Cmdlet          Get-Service                                        3.1.0.0    Microsof...
Cmdlet          Restart-Service                                    3.1.0.0    Microsof...
Cmdlet          Resume-Service                                     3.1.0.0    Microsof...
Cmdlet          Set-Service                                        3.1.0.0    Microsof...
Cmdlet          Start-Service                                      3.1.0.0    Microsof...
Cmdlet          Stop-Service                                       3.1.0.0    Microsof...
Cmdlet          Suspend-Service                                    3.1.0.0    Microsof...

Tutti questi comandi hanno un parametro che accetta un tipo di oggetto ServiceController tramite pipeline, input di parametro o entrambi.All of those commands have a parameter that accepts a ServiceController object type by pipeline, parameter input, or both.

Si noti che sono presenti più proprietà di quelle visualizzate per impostazione predefinita.Notice that there are more properties than are displayed by default. Anche se queste proprietà aggiuntive non vengono visualizzate per impostazione predefinita, possono essere selezionate dalla pipeline inviando il comando al cmdlet Select-Object e usando il parametro Property.Although these additional properties aren't displayed by default, they can be selected from the pipeline by piping the command to the Select-Object cmdlet and using the Property parameter. Nell'esempio seguente vengono selezionate tutte le proprietà inviando tramite pipe i risultati di Get-Service a Select-Object e specificando il carattere jolly * come valore per il parametro Property.The following example selects all of the properties by piping the results of Get-Service to Select-Object and specifying the * wildcard character as the value for the Property parameter.

Get-Service -Name w32time | Select-Object -Property *
Name                : w32time
RequiredServices    : {}
CanPauseAndContinue : False
CanShutdown         : True
CanStop             : True
DisplayName         : Windows Time
DependentServices   : {}
MachineName         : .
ServiceName         : w32time
ServicesDependedOn  : {}
ServiceHandle       : SafeServiceHandle
Status              : Running
ServiceType         : Win32ShareProcess
StartType           : Manual
Site                :
Container           :

È anche possibile selezionare proprietà specifiche usando un elenco delimitato da virgole per il valore del parametro Property.Specific properties can also be selected using a comma-separated list for the value of the Property parameter.

Get-Service -Name w32time | Select-Object -Property Status, Name, DisplayName, ServiceType
 Status Name    DisplayName        ServiceType
 ------ ----    -----------        -----------
Running w32time Windows Time Win32ShareProcess

Per impostazione predefinita, quattro proprietà vengono restituite in una tabella e cinque o più proprietà vengono restituite in un elenco.By default, four properties are returned in a table and five or more are returned in a list. Alcuni comandi usano la formattazione personalizzata per ignorare il numero di proprietà visualizzate per impostazione predefinita in una tabella.Some commands use custom formatting to override how many properties are displayed by default in a table. Sono disponibili diversi cmdlet Format-* che possono essere usati per eseguire manualmente l'override di queste impostazioni predefinite.There are several Format-* cmdlets that can be used to manually override these defaults. I più comuni sono Format-Table e Format-List, che verranno trattati in futuro in un capitolo.The most common ones are Format-Table and Format-List, both of which will be covered in an upcoming chapter.

È possibile usare caratteri jolly quando si specificano i nomi delle proprietà con Select-Object.Wildcard characters can be used when specifying the property names with Select-Object.

Get-Service -Name w32time | Select-Object -Property Status, DisplayName, Can*
Status              : Running
DisplayName         : Windows Time
CanPauseAndContinue : False
CanShutdown         : True
CanStop             : True

Nell'esempio precedente, Can* è stato usato come uno dei valori per il parametro Property per restituire tutte le proprietà che iniziano con Can.In the previous example, Can* was used as one of the values for the Property parameter to return all the properties that start with Can. Le proprietà includono CanPauseAndContinue, CanShutdown e CanStop.These include CanPauseAndContinue, CanShutdown, and CanStop.

MetodiMethods

I metodi sono un'azione che può essere eseguita.Methods are an action that can be taken. Usare il parametro MemberType per limitare i risultati di Get-Member per visualizzare solo i metodi per Get-Service.Use the MemberType parameter to narrow down the results of Get-Member to only show the methods for Get-Service.

Get-Service -Name w32time | Get-Member -MemberType Method
   TypeName: System.ServiceProcess.ServiceController

Name                      MemberType Definition
----                      ---------- ----------
Close                     Method     void Close()
Continue                  Method     void Continue()
CreateObjRef              Method     System.Runtime.Remoting.ObjRef CreateObjRef(type ...
Dispose                   Method     void Dispose(), void IDisposable.Dispose()
Equals                    Method     bool Equals(System.Object obj)
ExecuteCommand            Method     void ExecuteCommand(int command)
GetHashCode               Method     int GetHashCode()
GetLifetimeService        Method     System.Object GetLifetimeService()
GetType                   Method     type GetType()
InitializeLifetimeService Method     System.Object InitializeLifetimeService()
Pause                     Method     void Pause()
Refresh                   Method     void Refresh()
Start                     Method     void Start(), void Start(string[] args)
Stop                      Method     void Stop()
WaitForStatus             Method     void WaitForStatus(System.ServiceProcess.ServiceC...

Come si può notare, ci sono molti metodi.As you can see, there are many methods. Il metodo Stop può essere usato per arrestare un servizio Windows.The Stop method can be used to stop a Windows service.

(Get-Service -Name w32time).Stop()

Ora verificherò che il servizio Ora di Windows sia stato effettivamente arrestato.Now to verify the Windows time service has indeed been stopped.

Get-Service -Name w32time
Status   Name               DisplayName
------   ----               -----------
Stopped  w32time            Windows Time

Raramente mi trovo a usare i metodi, ma si tratta di un elemento che è necessario conoscere.I rarely find myself using methods, but they're something you need to be aware of. In alcuni casi è possibile incontrare un comando Get-* senza un comando corrispondente per modificare l'elemento.There are times that you'll come across a Get-* command without a corresponding command to modify that item. Spesso è possibile usare un metodo per eseguire un'azione che lo modifica.Often, a method can be used to perform an action that modifies it. Il cmdlet Get-SqlAgentJob nel modulo PowerShell SqlServer è un buon esempio.The Get-SqlAgentJob cmdlet in the SqlServer PowerShell module is a good example of this. Il modulo viene installato come parte di SQL Server Management Studio (SMSS).The module installs as part of SQL Server Management Studio (SMSS). Non esiste un cmdlet Set-* corrispondente, ma è possibile usare un metodo per completare la stessa attività.No corresponding Set-* cmdlet exists, but a method can be used to complete the same task.

Un altro motivo per conoscere i metodi è che molti principianti presuppongono che non sia possibile apportare modifiche distruttive con i comandi Get-*,Another reason to be aware of methods is that many beginners assume destructive changes can't be made with Get-* commands. mentre possono causare gravi problemi se usati in modo errato.But they indeed can cause serious problems if used inappropriately.

Un'opzione migliore consiste nell'usare un cmdlet per eseguire l'azione, se esistente.A better option is to use a cmdlet to perform the action if one exists. Avviare adesso il servizio Ora di Windows, ma questa volta usare il cmdlet per avviare i servizi.Go ahead and start the Windows Time service, except this time use the cmdlet for starting services.

Get-Service -Name w32time | Start-Service -PassThru
Status   Name               DisplayName
------   ----               -----------
Running  w32time            Windows Time

Per impostazione predefinita, Start-Service non restituisce alcun risultato proprio come il metodo di avvio di Get-Service.By default, Start-Service doesn't return any results just like the start method of Get-Service. Uno dei vantaggi derivanti dall'uso di un cmdlet è che molte volte il cmdlet offre funzionalità aggiuntive non disponibili con un metodo.But one of the benefits of using a cmdlet is that many times the cmdlet offers additional functionality that isn't available with a method. Nell'esempio precedente è stato usato il parametro PassThru.In the previous example, the PassThru parameter was used. In questo modo, un cmdlet che in genere non produce l'output genera l'output.This causes a cmdlet that doesn't normally produce output, to produce output.

Fare attenzione nel formulare ipotesi sull'output di un cmdlet.Be careful with assumptions about the output of a cmdlet. Tutti sanno cosa accade quando si fanno ipotesi.We all know what happens when you assume things. Recupererò le informazioni sul processo di PowerShell in esecuzione nel computer di ambiente lab di Windows 10.I'll retrieve information about the PowerShell process running on my Windows 10 lab environment computer.

Get-Process -Name PowerShell
Handles  NPM(K)    PM(K)      WS(K)     CPU(s)     Id  SI ProcessName
-------  ------    -----      -----     ------     --  -- -----------
    922      48   107984     140552       2.84   9020   1 powershell

Ora invierò lo stesso comando tramite pipe a Get-Member:Now I'll pipe that same command to Get-Member:

Get-Process -Name PowerShell | Get-Member
   TypeName: System.Diagnostics.Process

Name                       MemberType     Definition
----                       ----------     ----------
Handles                    AliasProperty  Handles = Handlecount
Name                       AliasProperty  Name = ProcessName
NPM                        AliasProperty  NPM = NonpagedSystemMemorySize64
PM                         AliasProperty  PM = PagedMemorySize64
SI                         AliasProperty  SI = SessionId
VM                         AliasProperty  VM = VirtualMemorySize64
WS                         AliasProperty  WS = WorkingSet64
Disposed                   Event          System.EventHandler Disposed(System.Object, ...
ErrorDataReceived          Event          System.Diagnostics.DataReceivedEventHandler ...
Exited                     Event          System.EventHandler Exited(System.Object, Sy...
OutputDataReceived         Event          System.Diagnostics.DataReceivedEventHandler ...
BeginErrorReadLine         Method         void BeginErrorReadLine()
BeginOutputReadLine        Method         void BeginOutputReadLine()
CancelErrorRead            Method         void CancelErrorRead()
CancelOutputRead           Method         void CancelOutputRead()
Close                      Method         void Close()
CloseMainWindow            Method         bool CloseMainWindow()
CreateObjRef               Method         System.Runtime.Remoting.ObjRef CreateObjRef(...
Dispose                    Method         void Dispose(), void IDisposable.Dispose()
Equals                     Method         bool Equals(System.Object obj)
GetHashCode                Method         int GetHashCode()
GetLifetimeService         Method         System.Object GetLifetimeService()
GetType                    Method         type GetType()
InitializeLifetimeService  Method         System.Object InitializeLifetimeService()
Kill                       Method         void Kill()
Refresh                    Method         void Refresh()
Start                      Method         bool Start()
ToString                   Method         string ToString()
WaitForExit                Method         bool WaitForExit(int milliseconds), void Wai...
WaitForInputIdle           Method         bool WaitForInputIdle(int milliseconds), boo...
__NounName                 NoteProperty   string __NounName=Process
BasePriority               Property       int BasePriority {get;}
Container                  Property       System.ComponentModel.IContainer Container {...
EnableRaisingEvents        Property       bool EnableRaisingEvents {get;set;}
ExitCode                   Property       int ExitCode {get;}
ExitTime                   Property       datetime ExitTime {get;}
Handle                     Property       System.IntPtr Handle {get;}
HandleCount                Property       int HandleCount {get;}
HasExited                  Property       bool HasExited {get;}
Id                         Property       int Id {get;}
MachineName                Property       string MachineName {get;}
MainModule                 Property       System.Diagnostics.ProcessModule MainModule ...
MainWindowHandle           Property       System.IntPtr MainWindowHandle {get;}
MainWindowTitle            Property       string MainWindowTitle {get;}
MaxWorkingSet              Property       System.IntPtr MaxWorkingSet {get;set;}
MinWorkingSet              Property       System.IntPtr MinWorkingSet {get;set;}
Modules                    Property       System.Diagnostics.ProcessModuleCollection M...
NonpagedSystemMemorySize   Property       int NonpagedSystemMemorySize {get;}
NonpagedSystemMemorySize64 Property       long NonpagedSystemMemorySize64 {get;}
PagedMemorySize            Property       int PagedMemorySize {get;}
PagedMemorySize64          Property       long PagedMemorySize64 {get;}
PagedSystemMemorySize      Property       int PagedSystemMemorySize {get;}
PagedSystemMemorySize64    Property       long PagedSystemMemorySize64 {get;}
PeakPagedMemorySize        Property       int PeakPagedMemorySize {get;}
PeakPagedMemorySize64      Property       long PeakPagedMemorySize64 {get;}
PeakVirtualMemorySize      Property       int PeakVirtualMemorySize {get;}
PeakVirtualMemorySize64    Property       long PeakVirtualMemorySize64 {get;}
PeakWorkingSet             Property       int PeakWorkingSet {get;}
PeakWorkingSet64           Property       long PeakWorkingSet64 {get;}
PriorityBoostEnabled       Property       bool PriorityBoostEnabled {get;set;}
PriorityClass              Property       System.Diagnostics.ProcessPriorityClass Prio...
PrivateMemorySize          Property       int PrivateMemorySize {get;}
PrivateMemorySize64        Property       long PrivateMemorySize64 {get;}
PrivilegedProcessorTime    Property       timespan PrivilegedProcessorTime {get;}
ProcessName                Property       string ProcessName {get;}
ProcessorAffinity          Property       System.IntPtr ProcessorAffinity {get;set;}
Responding                 Property       bool Responding {get;}
SafeHandle                 Property       Microsoft.Win32.SafeHandles.SafeProcessHandl...
SessionId                  Property       int SessionId {get;}
Site                       Property       System.ComponentModel.ISite Site {get;set;}
StandardError              Property       System.IO.StreamReader StandardError {get;}
StandardInput              Property       System.IO.StreamWriter StandardInput {get;}
StandardOutput             Property       System.IO.StreamReader StandardOutput {get;}
StartInfo                  Property       System.Diagnostics.ProcessStartInfo StartInf...
StartTime                  Property       datetime StartTime {get;}
SynchronizingObject        Property       System.ComponentModel.ISynchronizeInvoke Syn...
Threads                    Property       System.Diagnostics.ProcessThreadCollection T...
TotalProcessorTime         Property       timespan TotalProcessorTime {get;}
UserProcessorTime          Property       timespan UserProcessorTime {get;}
VirtualMemorySize          Property       int VirtualMemorySize {get;}
VirtualMemorySize64        Property       long VirtualMemorySize64 {get;}
WorkingSet                 Property       int WorkingSet {get;}
WorkingSet64               Property       long WorkingSet64 {get;}
PSConfiguration            PropertySet    PSConfiguration {Name, Id, PriorityClass, Fi...
PSResources                PropertySet    PSResources {Name, Id, Handlecount, WorkingS...
Company                    ScriptProperty System.Object Company {get=$this.Mainmodule....
CPU                        ScriptProperty System.Object CPU {get=$this.TotalProcessorT...
Description                ScriptProperty System.Object Description {get=$this.Mainmod...
FileVersion                ScriptProperty System.Object FileVersion {get=$this.Mainmod...
Path                       ScriptProperty System.Object Path {get=$this.Mainmodule.Fil...
Product                    ScriptProperty System.Object Product {get=$this.Mainmodule....
ProductVersion             ScriptProperty System.Object ProductVersion {get=$this.Main...

Si noti che sono elencate più proprietà di quelle visualizzate per impostazione predefinita.Notice that there are more properties listed than are displayed by default. Una serie di proprietà predefinite visualizzate non viene mostrata come proprietà quando si visualizzano i risultati di Get-Member.A number of the default properties displayed don't show up as properties when viewing the results of Get-Member. Questo accade perché molti dei valori visualizzati, ad esempio NPM(K), PM(K), WS(K) e CPU(s), sono proprietà calcolate.This is because many of the displayed values, such as NPM(K), PM(K), WS(K), and CPU(s), are calculated properties. Per determinare i nomi effettivi delle proprietà, il comando deve essere inviato tramite pipe a Get-Member.To determine the actual property names, the command must be piped to Get-Member.

Se un comando non genera output, non può essere inviato tramite pipe a Get-Member.If a command does not produce output, it can't be piped to Get-Member. Start-Service non produce alcun output per impostazione predefinita, quindi genera un errore quando si prova a inviarlo tramite pipe a Get-Member.Since Start-Service doesn't produce any output by default, it generates an error when you try to pipe it to Get-Member.

Start-Service -Name w32time | Get-Member
Get-Member : You must specify an object for the Get-Member cmdlet.
At line:1 char:31
+ Start-Service -Name w32time | Get-Member
+
    + CategoryInfo          : CloseError: (:) [Get-Member], InvalidOperationException
    + FullyQualifiedErrorId : NoObjectInGetMember,Microsoft.PowerShell.Commands.GetMembe
   rCommand

Il parametro PassThru può essere specificato con il cmdlet Start-Service per generare un output che viene quindi inviato tramite pipe a Get-Member senza errori.The PassThru parameter can be specified with the Start-Service cmdlet make it produce output, which is then piped to Get-Member without error.

Start-Service -Name w32time -PassThru | Get-Member
   TypeName: System.ServiceProcess.ServiceController

Name                      MemberType    Definition
----                      ----------    ----------
Name                      AliasProperty Name = ServiceName
RequiredServices          AliasProperty RequiredServices = ServicesDependedOn
Disposed                  Event         System.EventHandler Disposed(System.Object, Sy...
Close                     Method        void Close()
Continue                  Method        void Continue()
CreateObjRef              Method        System.Runtime.Remoting.ObjRef CreateObjRef(ty...
Dispose                   Method        void Dispose(), void IDisposable.Dispose()
Equals                    Method        bool Equals(System.Object obj)
ExecuteCommand            Method        void ExecuteCommand(int command)
GetHashCode               Method        int GetHashCode()
GetLifetimeService        Method        System.Object GetLifetimeService()
GetType                   Method        type GetType()
InitializeLifetimeService Method        System.Object InitializeLifetimeService()
Pause                     Method        void Pause()
Refresh                   Method        void Refresh()
Start                     Method        void Start(), void Start(string[] args)
Stop                      Method        void Stop()
WaitForStatus             Method        void WaitForStatus(System.ServiceProcess.Servi...
CanPauseAndContinue       Property      bool CanPauseAndContinue {get;}
CanShutdown               Property      bool CanShutdown {get;}
CanStop                   Property      bool CanStop {get;}
Container                 Property      System.ComponentModel.IContainer Container {get;}
DependentServices         Property      System.ServiceProcess.ServiceController[] Depe...
DisplayName               Property      string DisplayName {get;set;}
MachineName               Property      string MachineName {get;set;}
ServiceHandle             Property      System.Runtime.InteropServices.SafeHandle Serv...
ServiceName               Property      string ServiceName {get;set;}
ServicesDependedOn        Property      System.ServiceProcess.ServiceController[] Serv...
ServiceType               Property      System.ServiceProcess.ServiceType ServiceType ...
Site                      Property      System.ComponentModel.ISite Site {get;set;}
StartType                 Property      System.ServiceProcess.ServiceStartMode StartTy...
Status                    Property      System.ServiceProcess.ServiceControllerStatus ...
ToString                  ScriptMethod  System.Object ToString();

Per essere inviato tramite pipe a Get-Member, un comando deve produrre un output basato su oggetti.To be piped to Get-Member, a command must produce object-based output.

Get-Service -Name w32time | Out-Host | Get-Member
Status   Name               DisplayName
------   ----               -----------
Running  w32time            Windows Time

Get-Member : You must specify an object for the Get-Member cmdlet.
At line:1 char:40
+ Get-Service -Name w32time | Out-Host | Get-Member
+
    + CategoryInfo          : CloseError: (:) [Get-Member], InvalidOperationException
    + FullyQualifiedErrorId : NoObjectInGetMember,Microsoft.PowerShell.Commands.GetMemberCommand

Out-Host scrive direttamente nell'host PowerShell, ma non produce un output basato su oggetti per la pipeline.Out-Host writes directly to the PowerShell host, but it doesn't produce object-based output for the pipeline. Non è quindi possibile inviarlo tramite pipe a Get-Member.So it can't be piped to Get-Member.

Active DirectoryActive Directory

Nota

Per completare questa sezione è necessario avere Strumenti di amministrazione remota del server, indicato nella sezione requisiti di questo capitolo.The Remote Server Administration Tools listed in the requirements section of this chapter are required to complete this section. Come indicato nell'introduzione a questo documento, il computer dell'ambiente lab di Windows 10 deve essere un membro del dominio dell'ambiente lab.Also, as mentioned in the introduction to this book, your Windows 10 lab environment computer must be a member of the lab environment domain.

Usare Get-Command con il parametro Module per determinare quali comandi sono stati aggiunti come parte del modulo ActiveDirectory PowerShell quando è stato installato Strumenti di amministrazione remota del server.Use Get-Command with the Module parameter to determine what commands were added as part of the ActiveDirectory PowerShell module when the remote server administration tools were installed.

Get-Command -Module ActiveDirectory
CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Cmdlet          Add-ADCentralAccessPolicyMember                    1.0.0.0    ActiveDi...
Cmdlet          Add-ADComputerServiceAccount                       1.0.0.0    ActiveDi...
Cmdlet          Add-ADDomainControllerPasswordReplicationPolicy    1.0.0.0    ActiveDi...
Cmdlet          Add-ADFineGrainedPasswordPolicySubject             1.0.0.0    ActiveDi...
Cmdlet          Add-ADGroupMember                                  1.0.0.0    ActiveDi...
Cmdlet          Add-ADPrincipalGroupMembership                     1.0.0.0    ActiveDi...
Cmdlet          Add-ADResourcePropertyListMember                   1.0.0.0    ActiveDi...
Cmdlet          Clear-ADAccountExpiration                          1.0.0.0    ActiveDi...
Cmdlet          Clear-ADClaimTransformLink                         1.0.0.0    ActiveDi...
Cmdlet          Disable-ADAccount                                  1.0.0.0    ActiveDi...
...

Sono stati aggiunti un totale di 147 comandi come parte del modulo ActiveDirectory PowerShell.A total of 147 commands were added as part of the ActiveDirectory PowerShell module. Per impostazione predefinita, alcuni di questi comandi restituiscono solo una parte delle proprietà disponibili.Some commands of these commands only return a portion of the available properties by default.

Si è notato qualcosa di diverso nei nomi dei comandi in questo modulo?Did you notice anything different about the names of the commands in this module? La parte del nome dei comandi ha un prefisso AD.The noun portion of the commands has an AD prefix. È comune vedere questo prefisso nei comandi della maggior parte dei moduli.This is common to see on the commands of most modules. Il prefisso ha lo scopo di evitare conflitti di denominazione.The prefix is designed to help prevent naming conflicts.

Get-ADUser -Identity mike | Get-Member
   TypeName: Microsoft.ActiveDirectory.Management.ADUser

Name              MemberType            Definition
----              ----------            ----------
Contains          Method                bool Contains(string propertyName)
Equals            Method                bool Equals(System.Object obj)
GetEnumerator     Method                System.Collections.IDictionaryEnumerator GetEn...
GetHashCode       Method                int GetHashCode()
GetType           Method                type GetType()
ToString          Method                string ToString()
Item              ParameterizedProperty Microsoft.ActiveDirectory.Management.ADPropert...
DistinguishedName Property              System.String DistinguishedName {get;set;}
Enabled           Property              System.Boolean Enabled {get;set;}
GivenName         Property              System.String GivenName {get;set;}
Name              Property              System.String Name {get;}
ObjectClass       Property              System.String ObjectClass {get;set;}
ObjectGUID        Property              System.Nullable`1[[System.Guid, mscorlib, Vers...
SamAccountName    Property              System.String SamAccountName {get;set;}
SID               Property              System.Security.Principal.SecurityIdentifier S...
Surname           Property              System.String Surname {get;set;}
UserPrincipalName Property              System.String UserPrincipalName {get;set;}

Anche chi ha poca familiarità con Active Directory probabilmente sa che un account utente ha un numero maggiore di proprietà rispetto a quelle mostrate in questo esempio.Even if you're only vaguely familiar with Active Directory, you're probably aware that a user account has more properties than are shown in this example.

Il cmdlet Get-ADUser ha un parametro Properties usato per specificare le proprietà aggiuntive non predefinite che si vogliono restituire.The Get-ADUser cmdlet has a Properties parameter that is used to specify the additional (non-default) properties you want to return. Specificando il carattere jolly * vengono restituite tutte.Specifying the * wildcard character returns all of them.

Get-ADUser -Identity mike -Properties * | Get-Member
   TypeName: Microsoft.ActiveDirectory.Management.ADUser

Name                                 MemberType            Definition
----                                 ----------            ----------
Contains                             Method                bool Contains(string proper...
Equals                               Method                bool Equals(System.Object obj)
GetEnumerator                        Method                System.Collections.IDiction...
GetHashCode                          Method                int GetHashCode()
GetType                              Method                type GetType()
ToString                             Method                string ToString()
Item                                 ParameterizedProperty Microsoft.ActiveDirectory.M...
AccountExpirationDate                Property              System.DateTime AccountExpi...
accountExpires                       Property              System.Int64 accountExpires...
AccountLockoutTime                   Property              System.DateTime AccountLock...
AccountNotDelegated                  Property              System.Boolean AccountNotDe...
AllowReversiblePasswordEncryption    Property              System.Boolean AllowReversi...
AuthenticationPolicy                 Property              Microsoft.ActiveDirectory.M...
AuthenticationPolicySilo             Property              Microsoft.ActiveDirectory.M...
BadLogonCount                        Property              System.Int32 BadLogonCount ...
badPasswordTime                      Property              System.Int64 badPasswordTim...
badPwdCount                          Property              System.Int32 badPwdCount {g...
CannotChangePassword                 Property              System.Boolean CannotChange...
CanonicalName                        Property              System.String CanonicalName...
Certificates                         Property              Microsoft.ActiveDirectory.M...
City                                 Property              System.String City {get;set;}
CN                                   Property              System.String CN {get;}
codePage                             Property              System.Int32 codePage {get;...
Company                              Property              System.String Company {get;...
CompoundIdentitySupported            Property              Microsoft.ActiveDirectory.M...
Country                              Property              System.String Country {get;...
countryCode                          Property              System.Int32 countryCode {g...
Created                              Property              System.DateTime Created {get;}
createTimeStamp                      Property              System.DateTime createTimeS...
Deleted                              Property              System.Boolean Deleted {get;}
Department                           Property              System.String Department {g...
Description                          Property              System.String Description {...
DisplayName                          Property              System.String DisplayName {...
DistinguishedName                    Property              System.String Distinguished...
Division                             Property              System.String Division {get...
DoesNotRequirePreAuth                Property              System.Boolean DoesNotRequi...
dSCorePropagationData                Property              Microsoft.ActiveDirectory.M...
EmailAddress                         Property              System.String EmailAddress ...
EmployeeID                           Property              System.String EmployeeID {g...
EmployeeNumber                       Property              System.String EmployeeNumbe...
Enabled                              Property              System.Boolean Enabled {get...
Fax                                  Property              System.String Fax {get;set;}
GivenName                            Property              System.String GivenName {ge...
HomeDirectory                        Property              System.String HomeDirectory...
HomedirRequired                      Property              System.Boolean HomedirRequi...
HomeDrive                            Property              System.String HomeDrive {ge...
HomePage                             Property              System.String HomePage {get...
HomePhone                            Property              System.String HomePhone {ge...
Initials                             Property              System.String Initials {get...
instanceType                         Property              System.Int32 instanceType {...
isDeleted                            Property              System.Boolean isDeleted {g...
KerberosEncryptionType               Property              Microsoft.ActiveDirectory.M...
LastBadPasswordAttempt               Property              System.DateTime LastBadPass...
LastKnownParent                      Property              System.String LastKnownPare...
lastLogoff                           Property              System.Int64 lastLogoff {ge...
lastLogon                            Property              System.Int64 lastLogon {get...
LastLogonDate                        Property              System.DateTime LastLogonDa...
lastLogonTimestamp                   Property              System.Int64 lastLogonTimes...
LockedOut                            Property              System.Boolean LockedOut {g...
logonCount                           Property              System.Int32 logonCount {ge...
LogonWorkstations                    Property              System.String LogonWorkstat...
Manager                              Property              System.String Manager {get;...
MemberOf                             Property              Microsoft.ActiveDirectory.M...
MNSLogonAccount                      Property              System.Boolean MNSLogonAcco...
MobilePhone                          Property              System.String MobilePhone {...
Modified                             Property              System.DateTime Modified {g...
modifyTimeStamp                      Property              System.DateTime modifyTimeS...
msDS-User-Account-Control-Computed   Property              System.Int32 msDS-User-Acco...
Name                                 Property              System.String Name {get;}
nTSecurityDescriptor                 Property              System.DirectoryServices.Ac...
ObjectCategory                       Property              System.String ObjectCategor...
ObjectClass                          Property              System.String ObjectClass {...
ObjectGUID                           Property              System.Nullable`1[[System.G...
objectSid                            Property              System.Security.Principal.S...
Office                               Property              System.String Office {get;s...
OfficePhone                          Property              System.String OfficePhone {...
Organization                         Property              System.String Organization ...
OtherName                            Property              System.String OtherName {ge...
PasswordExpired                      Property              System.Boolean PasswordExpi...
PasswordLastSet                      Property              System.DateTime PasswordLas...
PasswordNeverExpires                 Property              System.Boolean PasswordNeve...
PasswordNotRequired                  Property              System.Boolean PasswordNotR...
POBox                                Property              System.String POBox {get;set;}
PostalCode                           Property              System.String PostalCode {g...
PrimaryGroup                         Property              System.String PrimaryGroup ...
primaryGroupID                       Property              System.Int32 primaryGroupID...
PrincipalsAllowedToDelegateToAccount Property              Microsoft.ActiveDirectory.M...
ProfilePath                          Property              System.String ProfilePath {...
ProtectedFromAccidentalDeletion      Property              System.Boolean ProtectedFro...
pwdAnswer                            Property              System.String pwdAnswer {ge...
pwdLastSet                           Property              System.Int64 pwdLastSet {ge...
pwdQuestion                          Property              System.String pwdQuestion {...
SamAccountName                       Property              System.String SamAccountNam...
sAMAccountType                       Property              System.Int32 sAMAccountType...
ScriptPath                           Property              System.String ScriptPath {g...
sDRightsEffective                    Property              System.Int32 sDRightsEffect...
ServicePrincipalNames                Property              Microsoft.ActiveDirectory.M...
SID                                  Property              System.Security.Principal.S...
SIDHistory                           Property              Microsoft.ActiveDirectory.M...
SmartcardLogonRequired               Property              System.Boolean SmartcardLog...
sn                                   Property              System.String sn {get;set;}
State                                Property              System.String State {get;set;}
StreetAddress                        Property              System.String StreetAddress...
Surname                              Property              System.String Surname {get;...
Title                                Property              System.String Title {get;set;}
TrustedForDelegation                 Property              System.Boolean TrustedForDe...
TrustedToAuthForDelegation           Property              System.Boolean TrustedToAut...
UseDESKeyOnly                        Property              System.Boolean UseDESKeyOnl...
userAccountControl                   Property              System.Int32 userAccountCon...
userCertificate                      Property              Microsoft.ActiveDirectory.M...
UserPrincipalName                    Property              System.String UserPrincipal...
uSNChanged                           Property              System.Int64 uSNChanged {get;}
uSNCreated                           Property              System.Int64 uSNCreated {get;}
whenChanged                          Property              System.DateTime whenChanged...
whenCreated                          Property              System.DateTime whenCreated...

A questo punto l'aspetto è più simile.Now that looks more like it.

Esiste un motivo per cui le proprietà di un account utente Active Directory sono così limitate per impostazione predefinita?Can you think of a reason why the properties of an Active Directory user account would be so limited by default? Si supponga che venga restituita ogni proprietà per ogni account utente nell'ambiente di produzione Active Directory.Imagine if you returned every property for every user account in your production Active Directory environment. Si pensi alla riduzione del livello delle prestazioni che può causare non solo ai controller di dominio, ma anche alla rete.Think of the performance degradation that you could cause, not only to the domain controllers themselves, but also to your network. È improbabile che sia necessaria comunque ogni proprietà.It's doubtful that you'll actually need every property anyway. La restituzione di tutte le proprietà per un singolo account utente è perfettamente accettabile quando si tenta di determinare quali sono le proprietà disponibili.Returning all of the properties for a single user account is perfectly acceptable when you're trying to determine what properties exist.

Non è insolito eseguire un comando molte volte durante la fase di prototipazione.It's not uncommon to run a command many times when prototyping it. Se si prevede di eseguire una query di grandi dimensioni, eseguirla una volta e archiviare i risultati in una variabile.If you're going to perform some huge query, query it once and store the results in a variable. Usare quindi il contenuto della variabile invece di usare ripetutamente una query dispendiosa.Then work with the contents of the variable instead of repeatedly using some expensive query.

$Users = Get-ADUser -Identity mike -Properties *

Usare il contenuto della variabile $Users invece di eseguire il comando precedente diverse volte.Use the contents of the $Users variable instead of running the previous command numerous times. Tenere presente che il contenuto della variabile non viene aggiornato quando vengono apportate modifiche all'utente in Active Directory.Keep in mind that the contents of the variable aren't updated when changes are made to that user in Active Directory.

È possibile inviare tramite pipe la variabile $Users a Get-Member per individuare le proprietà disponibili.You could pipe the $Users variable to Get-Member to discover the available properties.

$Users | Get-Member

Selezionare quindi le singole proprietà inviando $Users tramite pipe a Select-Object, senza dover eseguire query su Active Directory più di una volta.Then select the individual properties by piping $Users to Select-Object, all without ever having to query Active Directory more than one time.

$Users | Select-Object -Property Name, LastLogonDate, LastBadPasswordAttempt

Se si intende eseguire una query su Active Directory più di una volta, usare il parametro Properties per specificare le proprietà non predefinite desiderate.If you are going to query Active Directory more than once, use the Properties parameter to specify any non-default properties you want.

Get-ADUser -Identity mike -Properties LastLogonDate, LastBadPasswordAttempt
DistinguishedName      : CN=Mike F. Robbins,OU=Sales,DC=mikefrobbins,DC=com
Enabled                : True
GivenName              : Mike
LastBadPasswordAttempt : 2/4/2017 10:46:15 AM
LastLogonDate          : 2/18/2017 12:45:14 AM
Name                   : Mike F. Robbins
ObjectClass            : user
ObjectGUID             : a82a8c58-1332-4a57-a6e2-68e0c750ea56
SamAccountName         : mike
SID                    : S-1-5-21-2989741381-570885089-3319121794-1108
Surname                : Robbins
UserPrincipalName      : miker@mikefrobbins.com

SummarySummary

In questo capitolo si è appreso come determinare il tipo di oggetto prodotto da un comando, come determinare quali proprietà e metodi sono disponibili per un comando e come usare i comandi che limitano le proprietà restituite per impostazione predefinita.In this chapter, you've learned how to determine what type of object a command produces, how to determine what properties and methods are available for a command, and how to work with commands that limit the properties that are returned by default.

VerificaReview

  1. Quale tipo di oggetto produce il cmdlet Get-Process?What type of object does the Get-Process cmdlet produce?
  2. Come è possibile determinare quali sono le proprietà disponibili per un comando?How do you determine what the available properties are for a command?
  3. Se esiste un comando per ottenere un elemento, ma non per impostarlo, cosa si deve verificare?If a command exists for getting something but not for setting the same thing, what should you check for?
  4. Come è possibile far sì che determinati comandi che non producono output per impostazione predefinita lo producano?How can certain commands that don't produce output by default be made to produce output?
  5. Se si useranno i risultati di un comando che produce un'enorme quantità di output, cosa si può fare?If you're going to be working with the results of a command that produces an enormous amount of output, what should you consider doing?