comandos14.docx

2073

Click here to load reader

Upload: patrycia-fernandez-cardero

Post on 13-Dec-2014

335 views

Category:

Documents


106 download

TRANSCRIPT

POWERSHELLNOMBRE New-TimeSpan SINOPSIS Crea un objeto TimeSpan. SINTAXIS New-TimeSpan [[-Start] ] [[-End] ] [] New-TimeSpan [-Days ] [-Hours ] [-Minutes ] [-Seconds ] [] DESCRIPCIN El cmdlet New-TimeSpan crea un objeto TimeSpan que representa un intervalo de tiempo. Este objeto puede usarse para sumar o restar tiempo de los objetos DateTime. Sin parmetros, el comando "New-Timespan" devuelve un objeto TimeSpan que representa el intervalo de tiempo cero. PARMETROS -Days Indica los das de un intervalo de tiempo. El valor predeterminado es 0. -End Indica el final de un intervalo de tiempo. El valor predeterminado es la fecha y la hora actuales. -Hours Indica las horas de un intervalo de tiempo. El valor predeterminado es cero. -Minutes Indica los minutos de un intervalo de tiempo. El valor predeterminado es 0. -Seconds Indica el intervalo de tiempo en segundos. El valor predeterminado es 0. -Start Indica el inicio de un intervalo de tiempo. Escriba una cadena que representa la fecha y la hora, como "3/15/09" o un objeto DateTime, como el de un comando Get-Date. El valor predeterminado es la fecha y la hora actuales. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters".

-------------------------- EJEMPLO 1 -------------------------C:\PS>$timespan = new-timespan -hour 1 -minute 25 Descripcin ----------Este comando crea un objeto TimeSpan de 1 hora y 25 minutos de duracin y lo almacena en una variable denominada $timespan. Muestra una representacin del objeto TimeSpan. -------------------------- EJEMPLO 2 -------------------------C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1) Descripcin ----------En este ejemplo, se crea un nuevo objeto TimeSpan que representa el intervalo de tiempo comprendido entre la ejecucin del comando y el 1 de enero de 2010. Este comando no requiere el parmetro Start porque el valor predeterminado de este parmetro es la fecha y la hora actuales. -------------------------- EJEMPLO 3 -------------------------C:\PS>$90days = new-timespan -days 90 C:\PS> (get-date) + $90days Descripcin ----------Estos comandos devuelven la fecha correspondiente a 90 das despus de la fecha actual. NOTAS Para ver los ejemplos, escriba: "get-help New-TimeSpan -examples". Para obtener ms informacin, escriba: "get-help New-TimeSpan detailed". Para obtener informacin tcnica, escriba: "get-help New-TimeSpan full". NOMBRE Read-Host SINOPSIS Lee una lnea de entrada de la consola. SINTAXIS Read-Host [[-Prompt] ] [-AsSecureString] [] DESCRIPCIN El cmdlet Read-Host lee una lnea de entrada de la consola. Este cmdlet se puede usar para solicitar al usuario que proporcione datos. Dado que la entrada se puede guardar como una cadena segura, este cmdlet puede usarse para solicitar a los usuarios que proporcionen datos seguros, como contras

eas, as como datos compartidos. PARMETROS -AsSecureString [] Muestra asteriscos (*) en lugar de los caracteres que el usuario escribe. Cuando se usa este parmetro, el resultado del cmdlet Read-Host es un objeto SecureString (System.Security.SecureString). -Prompt Especifica el texto de la solicitud. Escriba una cadena. Si la cadena contiene espacios, escrbala entre comillas. Por ejemplo, "Type an integer: ". Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>$age = read-host "Please enter your age:" Descripcin ----------Este comando muestra la cadena "Please enter your age:" como un mensaje de solicitud de datos. Cuando se escribe un valor y se presiona la tecla ENTRAR, el valor se almacena en la variable $age.

-------------------------- EJEMPLO 2 -------------------------C:\PS>$pwd_secure_string = read-host "Enter a Password:" -assecurestring Descripcin ----------Este comando muestra la cadena "Enter a Password:" como un mensaje de solicitud de datos. Cuando se escribe un valor, en la consola aparecen asteriscos (*) en lugar del texto que se ha escrito. Cuando se presiona la tecla ENTRAR, se almacena el valor como un objeto SecureString en la variable $ pwd_secure_string.

NOTAS Para ver los ejemplos, escriba: "get-help Read-Host -examples". Para obtener ms informacin, escriba: "get-help Read-Host -detailed". Para obtener informacin tcnica, escriba: "get-help Read-Host -full". NOMBRE Set-Alias SINOPSIS

Crea o cambia un alias (nombre alternativo) de un cmdlet o cualquier otro elemento de comando de la sesin actual de Windows PowerShell. SINTAXIS Set-Alias [-Name] [-Value] [-Description ] [Force] [-Option {None | ReadOnly | Constant | Private | AllScope}] [PassThru] [-Scope ] [-Confirm] [-WhatIf] [] DESCRIPCIN El cmdlet Set-Alias crea o cambia un alias (nombre alternativo) de un cmdlet u otro elemento de comando, como una funcin, un script, un archivo u otro ejecutable. Tambin puede usar Set-Alias para reasignar el alias actual a un nuevo comando o cambiar cualquiera de las propiedades de un alias, como su descripcin. A menos que agregue el alias al perfil de Windows PowerShell, los cambios que realice en el alias se perdern al terminar la sesin o cerrar Windows PowerShell. PARMETROS -Description Especifica una descripcin del alias. Puede escribir cualquier cadena. Si la descripcin contiene espacios, escrbala entre comillas. -Force [] Permite al cmdlet establecer un alias de solo lectura. Utilice el parmetro Option para crear un alias de solo lectura. El parmetro Force no puede establecer un alias constante. -Name Especifica el nuevo alias. Pueden usarse caracteres alfanumricos en los alias, pero el primer carcter no puede ser un nmero. -Option Establece el valor de la propiedad Options de un alias. Los valores vlidos son: -- None: no establece opciones. (Valor predeterminado.) -- ReadOnly: no se pueden cambiar las propiedades del alias, excepto con el parmetro Force. Se puede usar Remove-Item para eliminar el alias. -- Constant: no se puede eliminar el alias ni se pueden cambiar sus propiedades. El valor Constant est disponible nicamente cuando se crea un alias. No se puede cambiar la opcin de un alias existente a Constant. -- Private: el alias solo est disponible en el mbito especificado por el parmetro Scope. En los dems mbitos, el alias no est visible. -- AllScope: el alias se copia en los nuevos mbitos que se creen. Para ver la propiedad Options de los alias, escriba "get-alias | format-table -property Name, Definition, Options -autosize". -PassThru [] Devuelve un objeto que representa el alias. De forma predeterminada, este cmdlet no genera resultados. -Scope

Especifica el mbito en el que es vlido este alias. Los valores vlidos son "Global", "Local", "Script" o el nmero correspondiente al mbito actual (entre 0 y el nmero de mbitos, donde 0 es el mbito actual y 1 su mbito principal). "Local" es el valor predeterminado. Para obtener ms i nformacin, vea about_Scopes. -Value Especifica el nombre del elemento de cmdlet o comando al que se asigna un alias. -Confirm [] Solicita confirmacin antes de ejecutar el comando. -WhatIf [] Describe lo que ocurrira si ejecutara el comando sin ejecutarlo realmente. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>set-alias -name list -value get-childitem Descripcin ----------Este comando crea el alias "list" para el cmdlet Get-ChildItem. Despus de crear el alias, podr usar "list" en lugar de "Get-ChildItem" en la lnea de comandos y en los scripts.

-------------------------- EJEMPLO 2 -------------------------C:\PS>set-alias list get-location Descripcin ----------Este comando asocia el alias "list" con el cmdlet Get-Location. Si "list" es el alias de otro cmdlet, este comando modificar su asociacin de modo que pase a ser nicamente el alias de Get-Location. Este comando usa el mismo formato que el comando del ejemplo anterior, pero omite los nombres de parmetros opcionales, -Name y -Value. Cuando se omiten los nombres de parmetros, los valores de esos parmetros deben aparecer en el comando en el orden especificado. En este caso, el valor de Na me ("list") debe ser el primer parmetro y el valor de -Value ("getlocation") debe ser el segundo parmetro.

-------------------------- EJEMPLO 3 --------------------------

C:\PS>set-alias scrub remove-item -option readonly -passthru | formatlist Descripcin ----------Este comando asocia el alias "scrub" con el cmdlet Remove-Item. Usa la opcin "ReadOnly" para evitar que se borre el alias o que se asigne a otro cmdlet. El parmetro PassThru indica a Windows PowerShell que pase un objeto que represente el nuevo alias a travs de la canalizacin al cmdlet Format-List. Si se omite el parmetro PassThru, no se generar ningn resultado en este cmdlet que pudiera mostrarse (en una lista u otro soporte).

-------------------------- EJEMPLO 4 -------------------------C:\PS>Set-Alias np c:\windows\notepad.exe Descripcin ----------Este comando asocia el alias "np" con el archivo ejecutable de Bloc de notas. Una vez que el comando finaliza su ejecucin, basta con escribir "np". para abrir Bloc de notas desde la lnea de comandos de Windows PowerShell. En este ejemplo se muestra cmo se crean alias para archivos ejecutables y otros elementos que no son cmdlets. Para que el comando resulte ms general, puede usarse la variable de entorno "Windir" (${env:windir}) para representar el directorio C\Windows. La versin genrica del comando es "set-alias np ${env:windir}\notepad.exe".

-------------------------- EJEMPLO 5 -------------------------C:\PS>function CD32 {set-location c:\windows\system32} C:\PS>set-alias go cd32 Descripcin ----------Estos comandos muestra cmo se asigna una alias a un comando con parmetros o incluso a una canalizacin de muchos comandos. Se puede crear un alias para un cmdlet, pero no se puede crear un alias para un comando compuesto por un cmdlet y sus parmetros. Sin embargo, si sita el comando en una funcin o un script, puede crear a continuacin un nombre til para a la funcin o el script, adems de uno o varios alias pa ra la funcin o el script. En este ejemplo, el usuario desea crear un alias para el comando "setlocation c:\windows\system32", donde "set-location" es un cmdlet y "C:\Windows\System32" es el valor del parmetro Path. Para ello, el primer comando crea una funcin denominada "CD32" que contiene el comando Set-Location.

El segundo comando crea el alias "go" para la funcin CD32. A continuacin, para ejecutar el comando Set-Location, el usuario puede escribir "CD32" o "go".

NOTAS Para ver los ejemplos, escriba: "get-help Set-Alias -examples". Para obtener ms informacin, escriba: "get-help Set-Alias -detailed". Para obtener informacin tcnica, escriba: "get-help Set-Alias -full". NOMBRE Select-String SINOPSIS Busca texto en cadenas y archivos. SINTAXIS Select-String [-Path] [-Pattern] [-AllMatches] [CaseSensitive] [-Context ] [-Encoding ] [-Exclude ] [-Include ] [-List] [-NotMatch] [-Quiet] [SimpleMatch] [] Select-String -InputObject [-Pattern] [AllMatches] [-CaseSensitive] [-Context ] [-Encoding ] [Exclude ] [-Include ] [-List] [-NotMatch] [-Quiet] [SimpleMatch] [] DESCRIPCIN El cmdlet Select-String busca texto y patrones de texto en los archivos y cadenas de entrada. Puede utilizarlo como Grep en UNIX y Findstr en Windows. Select-String se basa en lneas de texto. De forma predeterminada, Select-String busca la primera coincidencia en cada lnea y, para cada coincidencia, muestra el nombre de archivo, el nmero de lnea y todo el texto de la lnea que contiene la coincidencia. Sin embargo, puede indicar al cmdlet que detecte varias coincidencias por lnea, muestre el texto que figura antes y despus de la coincidencia, o bien, muestre nicamente un valor booleano (True o False) para indicar si se ha encontrado o no una coincidencia. Select-String utiliza la coincidencia de expresiones regulares, pero tambin puede usar una coincidencia simple que busca en la entrada el texto especificado. Select-String puede mostrar todas las coincidencias de texto o detenerse despus de la primera coincidencia en cada archivo de entrada. Tambin puede mostrar todo el texto que no coincide con el patrn especificado. Asimismo, se puede especificar que Select-String debe esperar una codificacin de caracteres determinada, por ejemplo, al buscar en archivos de texto Unicode. PARMETROS

-AllMatches [] Busca varias coincidencias en cada lnea de texto. Sin este parmetro, Select-String busca nicamente la primera coincidencia en cada lnea de texto. Cuando Select-String encuentra ms de una coincidencia en una lnea de texto, sigue emitiendo solo un objeto MatchInfo para la lnea pero la propiedad Matches del objeto contiene todas las coincidencias. -CaseSensitive [] Determina que debe distinguirse entre maysculas y minsculas en las coincidencias. De manera predeterminada, no se distingue entre maysculas y minsculas en las coincidencias. -Context Captura el nmero especificado de lneas antes y despus de la lnea con la coincidencia. Permite ver la coincidencia en su contexto. Si especifica un nmero como valor de este parmetro, ese nmero determina el nmero de lneas que se van a capturar antes y despus de la coincidencia. Si especifica dos nmeros como valor, el primer nmero determina el nmero de lneas antes de la coincidencia y el segundo nmero determin a el nmero de lneas despus de la coincidencia. De forma predeterminada, las lneas con una coincidencia se indican mediante un corchete angular de cierre (ASCII 62) en la primera columna. Las lneas sin marcar son el contexto. Este parmetro no cambia el nmero de objetos generados por SelectString. Select-String genera un objeto MatchInfo (Microsoft.PowerShell.Commands.MatchInfo) por cada coincidencia. El contexto se almacena como una matriz de cadenas en la propiedad Context del objeto. Al canalizar el resultado de un comando Select-String a otro comando Select-String, el comando que lo recibe busca solo en el texto de la lnea con la coincidencia (valor de la propiedad Line del objeto MatchInfo); no busca en el texto de las lneas de contexto. Como resultado, el parmetro Context no es vlido en el comando Select-String receptor. Cuando el contexto incluye una coincidencia, el objeto MatchInfo de cada coincidencia incluye todas las lneas de contexto, pero las lneas superpuestas se muestran solo una vez. -Encoding Especifica la codificacin de caracteres que Select-String debe suponer al buscar en el archivo. El valor predeterminado es UTF8. Los valores vlidos son "UTF7", "UTF8", "UTF32", "ASCII", "Unicode", "BigEndianUnicode", "Default" y "OEM". "Default" es la codificacin de la pgina de cdigos ANSI actual del sistema. "OEM" es el identificador de la pgina de cdigos del fabricante del equipo original actual del sistema o perativo. -Exclude Excluye los elementos especificados. El valor de este parmetro califica el parmetro Path. Escriba un patrn o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodn. -Include

Incluye nicamente los elementos especificados. El valor de este parmetro califica el parmetro Path. Escriba un patrn o un elemento de la ruta de acceso, como "*.txt". Se permite el uso de caracteres comodn. -InputObject Especifica el texto en el que se va a buscar. Escriba la variable que contenga el texto o escriba un comando o una expresin que lo obtenga. -List [] Devuelve solo la primera coincidencia en cada archivo de entrada. De forma predeterminada, Select-String devuelve un objeto MatchInfo por cada coincidencia que se encuentra. -NotMatch [] Busca texto que no coincide con el patrn especificado. -Path Especifica la ruta de acceso a los archivos en los que se va a buscar. Se permite el uso de caracteres comodn. La ubicacin predeterminada es el directorio local. Especifique archivos del directorio, como "log1.txt", "*.doc" o "*.*". Si especifica solo un directorio, el comando generar un error. -Pattern Especifica el texto que se va a buscar. Escriba una cadena o una expresin regular. Si escribe una cadena, utilice el parmetro SimpleMatch. Para obtener informacin sobre las expresiones regulares, vea about_Regular_Expressions. -Quiet [] Devuelve un valor booleano (true o false) en lugar de un objeto MatchInfo. El valor es "true" si se encuentra el patrn; de lo contrario, el valor es "false". -SimpleMatch [] Utiliza una coincidencia simple en lugar de una coincidencia de expresiones regulares. En una coincidencia simple, Select-String busca en la entrada el texto del parmetro Pattern. No interpreta el valor del parmetro Pattern como una instruccin de expresin regular. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>"Hello","HELLO" | select-string -pattern "HELLO" -casesensitive Descripcin ----------Este comando busca coincidencias con distincin entre minsculas y maysculas del texto que se canaliz al comando Select-String. Como resultado, Select-String solo encuentra "HELLO" porque "Hello" no coincide.

Dado que cada una de las cadenas entrecomilladas se trata como una lnea, sin el parmetro CaseSensitive, Select-String reconocera ambas cadenas como coincidencias.

-------------------------- EJEMPLO 2 -------------------------C:\PS>select-string -path *.xml -pattern "the the" Descripcin ----------Este comando busca en todos los archivos con la extensin .xml del directorio actual y muestra las lneas de esos archivos que contienen la cadena "the the".

-------------------------- EJEMPLO 3 -------------------------C:\PS>select-string -path $pshome\en-US\*.txt -pattern "@" Descripcin ----------Este comando busca en los archivos de Ayuda conceptual (about_*.txt) de Windows PowerShell informacin sobre el uso del signo arroba (@). Para indicar la ruta de acceso, este comando usa el valor de la variable automtica $pshome, que almacena la ruta de acceso al directorio de instalacin de Windows PowerShell. En este ejemplo, el comando busca en el subdirectorio en-US, que contiene los archivos de Ayuda de Windows PowerShell e n ingls (EE. UU.).

-------------------------- EJEMPLO 4 -------------------------C:\PS>function search-help { $pshelp = "$pshome\es\about_*.txt", "$pshome\en-US\*dll-help.xml" select-string -path $pshelp -pattern $args[0] } Descripcin ----------Esta funcin simple utiliza el cmdlet Select-String para buscar una cadena concreta en los archivos de Ayuda de Windows PowerShell. En este ejemplo, la funcin busca en el subdirectorio "en-US" los archivos de Ayuda en ingls de Estados Unidos. Si desea usar la funcin para buscar una cadena como "psdrive", escriba "search-help psdrive". Para utilizar esta funcin en cualquier consola de Windows PowerShell, cambie la ruta de acceso de modo que apunte a los archivos de Ayuda de Windows PowerShell en su sistema y, a continuacin, pegue la funcin en su perfil de Windows PowerShell.

-------------------------- EJEMPLO 5 -------------------------C:\PS>$events = get-eventlog -logname application -newest 100 C:\PS> $events | select-string -inputobject {$_.message} -pattern "failed" Descripcin ----------En este ejemplo, se busca la cadena "failed" en los 100 eventos ms recientes del registro de aplicaciones en el Visor de eventos. El primer comando utiliza el cmdlet Get-EventLog para obtener los 100 eventos ms recientes del registro de eventos de aplicacin. A continuacin, los almacena en la variable $events. El segundo comando usa un operador de canalizacin (|) para enviar los objetos almacenados en la variable $events a Select-String. Utiliza el parmetro InputObject para representar la entrada de la variable $events. El valor del parmetro InputObject es la propiedad Message de cada objeto cuand o pasa a travs de la canalizacin. El objeto actual viene representado por el smbolo $_. Cuando cada uno de los eventos llega a la canalizacin, Select-String busca en el valor de su propiedad Message la cadena "failed" y, a continuacin, muestra las lneas que incluyen una coincidencia.

-------------------------- EJEMPLO 6 -------------------------C:\PS>get-childitem c:\windows\system32\* -include *.txt -recurse | select-string -pattern "Microsoft" -casesensitive Descripcin ----------Este comando examina todos los archivos de los subdirectorios de C:\Windows\System32 que tienen la extensin .txt y busca la cadena "Microsoft". El parmetro CaseSensitive indica que la "M" de "Microsoft" debe estar en maysculas y el resto de los caracteres en minsculas para que Select-String encuentre una coincidencia.

-------------------------- EJEMPLO 7 -------------------------C:\PS>select-string -path process.txt -pattern idle, svchost -notmatch Descripcin ----------Este comando busca en el archivo Process.txt las lneas de texto que no incluyan la palabra "idle" o "svchost".

-------------------------- EJEMPLO 8 -------------------------C:\PS>$f = select-string -path audit.log -pattern "logon failed" context 2, 3 C:\PS> $f.count C:\PS> ($f)[0].context | format-list Descripcin ----------El primer comando busca en el archivo Audit.Log la cadena "logon failed". Utiliza el parmetro Context para capturar 2 lneas antes de la coincidencia y 3 lneas despus de la coincidencia. El segundo comando usa la propiedad Count de las matrices de objetos para mostrar el nmero de coincidencias encontradas; en este caso, son 2. El tercer comando muestra las lneas almacenadas en la propiedad Context del primer objeto MatchInfo. Utiliza la notacin de matriz para indicar la primera coincidencia (coincidencia 0 en una matriz de base cero) y usa el cmdlet Format-List para mostrar el valor de la propiedad Context como una lista. El resultado se compone de dos objetos MatchInfo, uno por cada coincidencia detectada. Las lneas de contexto se almacenan en la propiedad Context del objeto MatchInfo.

-------------------------- EJEMPLO 9 -------------------------C:\PS>$a = get-childitem $pshome\en-us\about*.help.txt | select-string pattern transcript C:\PS> $b = get-childitem $pshome\en-us\about*.help.txt | select-string -pattern transcript -allmatches C:\PS> $a C:\Windows\system32\WindowsPowerShell\v1.0\enus\about_Pssnapins.help.txt:39: Start-Transcript and Stop-Transcript. C:\PS> $b C:\Windows\system32\WindowsPowerShell\v1.0\enus\about_Pssnapins.help.txt:39: Start-Transcript and Stop-Transcript. C:\PS>> $a.matches Groups : {Transcript} Success : True Captures : {Transcript} Index : 13 Length : 10 Value : Transcript C:\PS> $b.matches

Groups Success Captures Index Length Value Groups Success Captures Index Length Value

: : : : : : : : : : : :

{Transcript} True {Transcript} 13 10 Transcript {Transcript} True {Transcript} 33 10 Transcript

Descripcin ----------En este ejemplo, se muestra el efecto del parmetro AllMatches de Select-String. AllMatches busca todas las coincidencias de patrn en una lnea en lugar de buscar simplemente la primera coincidencia en cada lnea. El primer comando del ejemplo busca en los archivos de Ayuda conceptual (Ayuda "about") de Windows PowerShell instancias de la palabra "transcript". El segundo comando es idntico, salvo en que utiliza el parmetro AllMatches. El resultado del primer comando se guarda en la variable $a. El resultado del segundo comando se guarda en la variable $b. De forma predeterminada, las variables tienen valores idnticos, tal y como se muestra en el resultado de ejemplo. Sin embargo, el quinto y el sexto comando muestran el valor de la propiedad Matches de cada objeto. La propiedad Matches del primer comando contiene solo una coincidencia (es decir, un objeto System.Text.RegularExpressions.Match), mientras que la propiedad Matches del segundo comando contiene o bjetos para ambas coincidencias en la lnea.

NOTAS Para ver los ejemplos, escriba: "get-help Select-String -examples". Para obtener ms informacin, escriba: "get-help Select-String detailed". Para obtener informacin tcnica, escriba: "get-help Select-String full". NOMBRE Measure-Object SINOPSIS Calcula las propiedades numricas de los objetos as como los caracteres, palabras y lneas en los objetos de cadena, como archivos de texto. SINTAXIS Measure-Object [-Average] [-Maximum] [-Minimum] [-Sum] [[-Property] ] [-InputObject ] []

Measure-Object [-Character] [-IgnoreWhiteSpace] [-Line] [-Word] [[Property] ] [-InputObject ] [] DESCRIPCIN El cmdlet Measure-Object calcula los valores de propiedad de determinados tipos de objetos. Measure-Object realiza tres tipos de mediciones, segn los parmetros del comando. El cmdlet Measure-Object realiza clculos con los valores de propiedad de los objetos. Puede contar objetos y calcular el mnimo, el mximo, la suma y el promedio de los valores numricos. En el caso de los objetos de texto, puede contar y calcular el nmero de lneas, palabras y caracteres. PARMETROS -Average [] Muestra el promedio de las propiedades especificadas. -Character [] Cuenta el nmero de caracteres del objeto de entrada. -IgnoreWhiteSpace [] Omite los espacios en blanco al contar el nmero de palabras y caracteres. De forma predetermina, se tienen en cuenta los espacios en blanco. -InputObject Especifica los objetos que se van a medir. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresin que obtenga los objetos. -Line [] Cuenta el nmero de lneas del objeto de entrada. -Maximum [] Muestra el valor mximo de las propiedades especificadas. -Minimum [] Muestra el valor mnimo de las propiedades especificadas. -Property Especifica una o varias propiedades numricas que se van a medir. El valor predeterminado es la propiedad Count (Length) del objeto. -Sum [] Muestra la suma de los valores de las propiedades especificadas. -Word [] Cuenta el nmero de palabras en el objeto de entrada. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>get-childitem | measure-object Descripcin

----------Este comando cuenta los archivos y carpetas del directorio actual.

-------------------------- EJEMPLO 2 -------------------------C:\PS>get-childitem | measure-object -property length -minimum -maximum -average Descripcin ----------Este comando muestra el tamao mnimo, el tamao mximo y la suma de los tamaos de todos los archivos ubicados en el directorio actual, as como el tamao de archivo medio del directorio.

-------------------------- EJEMPLO 3 -------------------------C:\PS>get-content C:\test.txt | measure-object -character -line -word Descripcin ----------Este comando muestra el nmero de caracteres, palabras y lneas del archivo Text.txt.

-------------------------- EJEMPLO 4 -------------------------C:\PS>get-process | measure-object -property workingset -minimum maximum -average Descripcin ----------Este comando muestra el tamao mnimo, el tamao mximo y el tamao medio de los conjuntos de trabajo de los procesos en el equipo.

-------------------------- EJEMPLO 5 -------------------------C:\PS>import-csv d:\test\serviceyrs.csv | measure-object -property years -minimum -maximum -average Descripcin ----------Este comando calcula el promedio de los aos de servicio de los empleados de una compaa. El archivo ServiceYrs.csv es un archivo CSV que contiene el nmero de empleados y los aos de servicio de cada empleado. La primera fila de la tabla es la fila de encabezado "EmpNo, Years". Cuando se usa Import-Csv para importar el archivo, el resultado es un objeto PSCustomObject con EmpNo y Years como propiedades Note. Se puede

utilizar Measure-Object para calcular los valores de estas propiedades, al igual que cualquier otra propiedad de un objeto.

-------------------------- EJEMPLO 6 -------------------------C:\PS>get-childitem | measure-object -property psiscontainer -max -sum min -average Count Average Sum Maximum Minimum Property : : : : : : 126 0.0634920634920635 8 1 0 PSIsContainer

Descripcin ----------En este ejemplo, se muestra que Measure-Object puede medir valores booleanos. En este caso, se utiliza la propiedad booleana PSIsContainer para medir la incidencia de carpetas (con respecto a archivos) en el directorio actual.

NOTAS Para ver los ejemplos, escriba: "get-help Measure-Object -examples". Para obtener ms informacin, escriba: "get-help Measure-Object detailed". Para obtener informacin tcnica, escriba: "get-help Measure-Object full". NOMBRE New-Alias SINOPSIS Crea un nuevo alias. SINTAXIS New-Alias [-Name] [-Value] [-Description ] [Force] [-Option {None | ReadOnly | Constant | Private | AllScope}] [PassThru] [-Scope ] [-Confirm] [-WhatIf] [] DESCRIPCIN El cmdlet New-Alias crea un nuevo alias en la actual sesin de Windows PowerShell. Los alias que se crean mediante New-Alias no se guardan cuando se cierra la sesin o Windows PowerShell. Puede usar el cmdlet Export-Alias para guardar la informacin de los alias en un archivo. Despus, puede us ar Import-Alias para recuperar esta informacin. PARMETROS -Description Especifica una descripcin del alias. Puede escribir cualquier cadena. Si la descripcin contiene espacios, escrbala entre comillas.

-Force [] Cuando se define, acta como set-alias si el alias especificado ya existe. -Name Especifica el nuevo alias. Pueden usarse caracteres alfanumricos en los alias, pero el primer carcter no puede ser un nmero. -Option Define una o varias propiedades opcionales del alias. Los valores vlidos son: -- None: no establece opciones. (Valor predeterminado.) -- ReadOnly: no se puede modificar el alias a menos que se use el parmetro Force. -- Constant: no se puede modificar el alias, ni siquiera mediante el parmetro Force. -- Private: el alias solo est disponible en el mbito especificado por el parmetro Scope. En los dems mbitos, el alias no est visible. -PassThru [] Devuelve un objeto que representa el nuevo alias. De forma predeterminada, este cmdlet no genera resultados. -Scope Especifica el mbito del nuevo alias. Los valores vlidos son "Global", "Local", "Script" o el nmero correspondiente al mbito actual (entre 0 y el nmero de mbitos, donde 0 es el mbito actual y 1 su mbito principal). "Local" es el valor predeterminado. Para obtener ms informacin, vea about_Scopes. -Value Especifica el nombre del elemento de cmdlet o comando al que se asigna un alias. -Confirm [] Solicita confirmacin antes de ejecutar el comando. -WhatIf [] Describe lo que ocurrira si ejecutara el comando sin ejecutarlo realmente. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>new-alias list get-childitem Descripcin ----------Este comando crea un alias denominado "list" para representar el cmdlet Get-ChildItem.

-------------------------- EJEMPLO 2 -------------------------C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly C:\PS> get-alias -name w | format-list * Descripcin ----------Este comando crea un alias denominado "w" para representar el cmdlet Get-WMIObject. Crea una descripcin, "quick wmi alias", para el alias de slo lectura. La ltima lnea del comando usa Get-Alias para obtener el nuevo alias y lo canaliza a Format-List para mostrar toda la informacin sobre l .

NOTAS Para ver los ejemplos, escriba: "get-help New-Alias -examples". Para obtener ms informacin, escriba: "get-help New-Alias -detailed". Para obtener informacin tcnica, escriba: "get-help New-Alias -full". NOMBRE Set-Date SINOPSIS Cambia la hora del sistema en el equipo a la hora especificada. SINTAXIS Set-Date [-Adjust] [-DisplayHint {Date | Time | DateTime}] [Confirm] [-WhatIf] [] Set-Date [-Date] [-DisplayHint {Date | Time | DateTime}] [Confirm] [-WhatIf] [] DESCRIPCIN El cmdlet Set-Date modifica la fecha y la hora del sistema en el equipo a la fecha y hora especificadas. Se puede establecer una nueva fecha y hora escribiendo una cadena o pasando un objeto DateTime o TimeSpan a Set-Date. Para especificar una fecha o una hora nueva, use el parmetro Date. Para especificar un intervalo de cambio, use el parmetro Adjust. PARMETROS -Adjust Suma o resta el valor especificado de la fecha y hora actuales. Puede escribir un ajuste en el formato de fecha y hora estndar de la configuracin regional o usar el parmetro Adjust para pasar un objeto TimeSpan de New-TimeSpan a Set-Date. -Date Cambia la fecha y la hora a los valores especificados. Puede escribir una nueva fecha en el formato abreviado y una hora en el formato

estndar para la configuracin regional. Tambin puede pasar un objeto DateTime desde Get-Date. Si se especifica una fecha pero no una hora, Set-Date cambia la hora a la medianoche de la fecha especificada. Si slo se especifica una hora, no se modifica la fecha. -DisplayHint Determina qu elementos de fecha y hora se muestran. Los valores vlidos son: -- date: muestra solo la fecha -- time: muestra solo la hora -- datetime: muestra la fecha y la hora Este parmetro afecta nicamente a la presentacin. No afecta al objeto DateTime que Get-Date recupera. -Confirm [] Solicita confirmacin antes de ejecutar el comando. -WhatIf [] Describe lo que ocurrira si ejecutara el comando sin ejecutarlo realmente. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>Set-Date -Date (Get-Date).AddDays(3) Descripcin ----------Este comando suma tres das a la fecha actual del sistema. No tiene ningn efecto sobre la hora. El comando usa el parmetro Date para especificar la fecha. Usa el cmdlet Get-Date para obtener la fecha y la hora actuales y aplica a los objetos DateTime el mtodo AddDays de .NET con el valor 3 ( das).

-------------------------- EJEMPLO 2 -------------------------C:\PS>set-date -adjust -0:10:0 -displayHint time Descripcin ----------Este comando retrasa la hora actual del sistema en 10 minutos. Usa el parmetro Adjust para especificar un intervalo de cambio y el cambio de hora (menos 10 minutos) en el formato de hora estndar de la configuracin regional. El parmetro DisplayHint indica a Windows PowerShell que muestre ni camente la hora, pero no afecta al objeto DateTime devuelto por SetDate.

-------------------------- EJEMPLO 3 -------------------------C:\PS>$t = get-date C:\PS>set-date -date $t Descripcin ----------Estos comando cambian la fecha y la hora del sistema en el equipo a la fecha y hora almacenadas en la variable $t. El primer comando obtiene la fecha y la almacena en la variable $t. El segundo comando usa el parmetro Date para pasar el objeto DateTime de $t al cmdlet Set-Date.

-------------------------- EJEMPLO 4 -------------------------C:\PS>$90mins = new-timespan -minutes 90 C:\PS>set-date -adjust $90mins Descripcin ----------Estos comandos adelantan las horas del sistema en el equipo local en 90 minutos. El primer comando usa el cmdlet New-Timespan para crear un objeto TimeSpan con un intervalo de 90 minutos y, a continuacin, guarda el objeto TimeSpan en la variable $90mins. El segundo comando usa el parmetro Adj ust de Set-Date para ajustar la fecha por el valor del objeto TimeSpan almacenado en la variable $90mins.

NOTAS Para ver los ejemplos, escriba: "get-help Set-Date -examples". Para obtener ms informacin, escriba: "get-help Set-Date -detailed". Para obtener informacin tcnica, escriba: "get-help Set-Date -full". NOMBRE Update-List SINOPSIS Agrega y quita elementos de un valor de propiedad que contiene una coleccin de objetos. SINTAXIS Update-List [-Add ] [-Remove ] [[-Property] ] [-InputObject ] [] Update-List -Replace [[-Property] ] [-InputObject ] [] DESCRIPCIN

El cmdlet Update-List agrega y quita elementos de un valor de propiedad de un objeto y, a continuacin, devuelve el objeto actualizado. Este cmdlet se ha diseado para propiedades que contienen colecciones de objetos. Los parmetros Add y Remove agregan y quitan elementos individuales de la coleccin. El parmetro Replace reemplaza toda coleccin. Si no se especifica ninguna propiedad en el comando, Update-List devuelve un objeto que describe la actualizacin en lugar de actualizar el objeto. El objeto de actualizacin se puede enviar a cmdlets que cambian objetos, como los cmdlets Set-*. Este cmdlet funciona nicamente cuando la propiedad que se est actualizando admite la interfaz IList utilizada por Update-List. Adems, los cmdlets Set-* que aceptan una actualizacin deben admitir la interfaz IList. Los cmdlets bsicos que se instalan con Windows PowerShell no admiten esta in terfaz. Para determinar si un cmdlet admite Update-List, vea el tema de Ayuda del cmdlet. PARMETROS -Add Especifica los valores de propiedad que se van a agregar a la coleccin. Especifique los valores en el orden en que deben aparecer en la coleccin. -InputObject Especifica los objetos que se van a actualizar. El objeto que se va a actualizar tambin se puede canalizar a Update-List. -Property Identifica la propiedad que contiene la coleccin que se est actualizando. Si se omite este parmetro, Update-List devuelve un objeto que representa el cambio en lugar de cambiar el objeto. -Remove Especifica los valores de propiedad que se van a quitar de la coleccin. -Replace Especifica una nueva coleccin. Este parmetro reemplaza todos los elementos de la coleccin original con los elementos especificados por este parmetro. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>get-mailbox | update-list -Property aliases -Add "A","B" -Remove "X","Y" | set-mailbox Descripcin ----------Este comando agrega A y B y quita X e Y de la propiedad Aliases de un buzn.

El comando utiliza el cmdlet Get-MailBox de Microsoft Exchange Server para obtener el buzn. Un operador de canalizacin enva el objeto de buzn al cmdlet Update-List. El comando Update-List utiliza el parmetro Property para indicar que se est actualizando la propiedad Aliases del buzn, y usa los parmetros Add y Remove para especificar los elementos que se agregan y se quitan de la coleccin. La propiedad Aliases cumple las condiciones de Update-List porq ue almacena una coleccin de objetos de Microsoft .NET Framework que tienen los mtodos Add y Remove. El cmdlet Update-List devuelve el buzn actualizado. Este se canaliza al cmdlet Set-MailBox, que cambia el buzn. Para obtener ms informacin sobre Get-Mailbox, vea http://go.microsoft.com/fwlink/?LinkId=111536.

-------------------------- EJEMPLO 2 -------------------------C:\PS>$m = get-mailbox C:\PS> update-list -InputObject $m -Property aliases -Add "A","B" Remove "X", "Y" | set-mailbox Descripcin ----------Este comando agrega A y B al valor de la propiedad Aliases de un buzn y quita X e Y. Este comando tiene el mismo efecto que el comando anterior, aunque tiene un formato ligeramente diferente. El comando utiliza el cmdlet Get-MailBox para obtener el buzn y guarda el buzn en la variable $m. Este comando utiliza el parmetro InputObject de Update-List para especificar el buzn. El valor de InputObject es el buzn almacenado en la variable $m. Utiliza el parmetro Property para especi ficar la propiedad Aliases y usa los parmetros Add y Remove para especificar los elementos que se agregan y se quitan del valor de Alias. El comando utiliza un operador de canalizacin (|) para enviar el objeto de buzn actualizado al cmdlet Set-Mailbox, que cambia el buzn.

-------------------------- EJEMPLO 3 -------------------------C:\PS>get-mailbox | set-mailbox -alias (update-list -Add "A", "B" Remove "X","Y") Descripcin ----------Este comando agrega A y B al valor de la propiedad Aliases de un buzn y quita X e Y. Este comando tiene el mismo efecto que los dos comandos anteriores, pero sigue un procedimiento distinto para llevar a cabo la tarea. En lugar de actualizar la propiedad Aliases del buzn antes de enviarla a Set-Mailbox, este comando utiliza Update-List para crear un objeto que

representa el cambio. A continuacin, enva el cambio al parmetro Alias de Set-Mailbox. El comando utiliza el cmdlet Get-MailBox para obtener el buzn. Un operador de canalizacin enva el objeto de buzn al cmdlet Set-Mailbox, que cambia el buzn. El comando utiliza el parmetro Alias de Set-Mailbox para cambiar la propiedad Aliases del objeto de buzn. El valor del parmetro Alias es un comando Update-List que crea un objeto que representa la actualizacin. El comando Update-List se encuentra entre parntesis para asegurar que se ejecut e antes de que se evale el valor del parmetro Alias. Cuando se complete el comando Set-Mailbox, el buzn cambiar.

-------------------------- EJEMPLO 4 -------------------------C:\PS>update-list -InputObject $a -Property aliases -replace "A", "B" | set-mailbox Descripcin ----------Este comando utiliza el operador Replace de Update-List para reemplazar la coleccin en la propiedad Aliases del objeto de $a con una nueva coleccin. Este comando utiliza el parmetro InputObject, lo que en este caso equivale a utilizar un operador de canalizacin para pasar $a a Update-List.

NOTAS Para ver los ejemplos, escriba: "get-help Update-List -examples". Para obtener ms informacin, escriba: "get-help Update-List -detailed". Para obtener informacin tcnica, escriba: "get-help Update-List -full". NOMBRE Update-TypeData SINOPSIS Actualiza la configuracin del tipo extendido actual al volver a cargar los archivos *.types.ps1xml en la memoria. SINTAXIS Update-TypeData [[-AppendPath] ] [-PrependPath ] [Confirm] [-WhatIf] [] DESCRIPCIN El cmdlet Update-TypeData actualiza la configuracin del tipo extendido actual al volver a cargar los archivos *.types.ps1xml en la memoria. La informacin de tipo extendido normalmente se carga cuando Windows PowerShell necesita la informacin de tipo que contiene. El cmdlet Update-TypeData pu ede usarse para cargar previamente toda la informacin de los tipos. Resulta especialmente til cuando programa tipos y desea cargar estos nuevos tipos para realizar pruebas.

Para obtener ms informacin sobre los archivos *types.ps1xml de Windows PowerShell, vea about_Types.ps1xml. PARMETROS -AppendPath Especifica la ruta de acceso a los archivos .ps1xml opcionales que se incluirn en la lista de archivos cargados. Estos archivos se procesan una vez que se han cargado los archivos integrados. -PrependPath Especifica la ruta de acceso a los archivos .ps1xml opcionales que se incluirn en la lista de archivos cargados. No obstante, estos archivos se procesan en el orden especificado y antes de que se carguen los archivos integrados. -Confirm [] Solicita confirmacin antes de ejecutar el comando. -WhatIf [] Describe lo que ocurrira si ejecutara el comando sin ejecutarlo realmente. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>update-typedata Descripcin ----------Este ejemplo actualiza la configuracin de los tipos extendidos de los archivos *.types.ps1xml.

-------------------------- EJEMPLO 2 -------------------------C:\PS>update-typedata -prependpath typesA.types.Ps1xml, typesB.types.Ps1xml Descripcin ----------En este ejemplo se actualiza la configuracin de los tipos extendidos de los archivos *.types.ps1xml y, para ello, se procesan primero los archivos typesA y typesB.

NOTAS Para ver los ejemplos, escriba: "get-help Update-TypeData -examples". Para obtener ms informacin, escriba: "get-help Update-TypeData detailed".

Para obtener informacin tcnica, escriba: "get-help Update-TypeData full". NOMBRE Update-FormatData SINOPSIS Actualiza los datos de formato de la sesin actual. SINTAXIS Update-FormatData [[-AppendPath] ] [-PrependPath ] [-Confirm] [-WhatIf] [] DESCRIPCIN El cmdlet Update-FormatData vuelve a cargar en la sesin actual los datos de formato de los archivos de formato. Este cmdlet permite actualizar los datos de formato sin reiniciar Windows PowerShell. Sin parmetros, Update-FormatData vuelve a cargar los archivos de formato que carg anteriormente. Puede utilizar los parmetros de UpdateFormatData para agregar nuevos archivos de formato a la sesin. Los archivos de formato son archivos de texto en formato XML con la extensin format.ps1xml. Los datos de formato incluidos en los archivos definen cmo se muestran los objetos de Microsoft .NET Framework en la sesin. Cuando se inicia Windows PowerShell, se cargan en la sesin los datos de formato de los archivos de formato ubicados en el directorio de instalacin de Windows PowerShell ($pshome). Puede utilizar Update-FormatData para volver a cargar los datos de formato en la sesin actual sin tener que rein iciar Windows PowerShell. Este cmdlet resulta til si ha agregado o cambiado un archivo de formato pero no desea interrumpir la sesin. Para obtener ms informacin sobre los archivos de formato de Windows PowerShell, vea about_Format.ps1xml. PARMETROS -AppendPath Agrega los archivos de formato especificados a la sesin. Los archivos se cargan despus de que Windows PowerShell haya cargado los archivos de formato integrados. Al dar formato a los objetos de .NET, Windows PowerShell utiliza la primera definicin de formato que encuentre para cada tipo de .NET. Si utiliza el parmetro AppendPath, Windows PowerShell buscar en los datos de los archivos integrados antes de detectar los datos de formato que se agrega n. Utilice este parmetro para agregar un archivo que da formato a un objeto de .NET al que no se hace referencia en los archivos de formato integrados. -PrependPath Agrega los archivos de formato especificados a la sesin. Los archivos se cargan antes de que Windows PowerShell cargue los archivos de formato integrados.

Al dar formato a los objetos de .NET, Windows PowerShell utiliza la primera definicin de formato que encuentre para cada tipo de .NET. Si utiliza el parmetro PrependPath, Windows PowerShell buscar en los datos de los archivos que se agregan antes de detectar los datos de formato de los a rchivos integrados. Utilice este parmetro para agregar un archivo que da formato a un objeto de .NET al que tambin se hace referencia en los archivos de formato integrados. -Confirm [] Solicita confirmacin antes de ejecutar el comando. -WhatIf [] Describe lo que ocurrira si ejecutara el comando sin ejecutarlo realmente. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>update-formatdata Descripcin ----------Este comando vuelve a cargar los archivos de formato que carg anteriormente.

-------------------------- EJEMPLO 2 -------------------------C:\PS>update-formatdata -appendpath trace.format.ps1xml, log.format.ps1xml Descripcin ----------Este comando vuelve a cargar en la sesin los archivos de formato, incluidos dos archivos nuevos, Trace.format.ps1xml y Log.format.ps1xml. Dado que el comando utiliza el parmetro AppendPath, los datos de formato incluidos en los nuevos archivos se cargan despus de que se hayan cargado los datos de formato de los archivos integrados. Se utiliza el parmetro AppendPath porque los nuevos archivos contienen datos de formato para los objetos a los que no se hace referencia en los archivos integrados.

-------------------------- EJEMPLO 3 -------------------------C:\PS>update-formatdata -prependPath c:\test\NewFiles.format.ps1xml # Edit the NewFiles.format.ps1 file.

C:\PS> update-formatdata Descripcin ----------En este ejemplo, se muestra cmo volver a cargar un archivo de formato despus de haberlo modificado. El primer comando agrega el archivo NewFiles.format.ps1xml a la sesin. Utiliza el parmetro PrependPath porque el archivo contiene datos de formato para los objetos a los que se hace referencia en los archivos integrados. Despus de agregar el archivo NewFiles.format.ps1xml y probarlo en la sesin, el autor edita el archivo. El segundo comando usa el cmdlet Update-FormatData para volver a cargar los archivos de formato. Dado que el archivo NewFiles.format.ps1xml ya se carg anteriormente, Update-FormatData vuelve a cargarlo automticamente sin usar ningn parmetro.

NOTAS Para ver los ejemplos, escriba: "get-help Update-FormatData -examples". Para obtener ms informacin, escriba: "get-help Update-FormatData detailed". Para obtener informacin tcnica, escriba: "get-help Update-FormatData full". NOMBRE Start-Sleep SINOPSIS Suspende la actividad en un script o una sesin durante el perodo de tiempo especificado. SINTAXIS Start-Sleep -Milliseconds [] Start-Sleep [-Seconds] [] DESCRIPCIN El cmdlet Start-Sleep suspende la actividad en un script o una sesin durante el perodo de tiempo especificado. Puede utilizarlo para muchas tareas, por ejemplo, para esperar a que se complete una operacin o pausar antes de que se repita una operacin. PARMETROS -Milliseconds Especifica el perodo de tiempo en milisegundos que el recurso est suspendido. El parmetro puede abreviarse como "-m". -Seconds Especifica el perodo de tiempo en segundos que el recurso est suspendido. Se puede omitir el nombre del parmetro ("Seconds") o se puede abreviarlo como "-s".

Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>Start-Sleep -s 15 Descripcin ----------Este comando suspende durante 15 segundos la actividad de todos los comandos de la sesin.

-------------------------- EJEMPLO 2 -------------------------C:\PS>Start-Sleep -m 500 Descripcin ----------Este comando suspende durante medio segundo (500 milisegundos) la actividad de todos los comandos de la sesin.

NOTAS Para ver los ejemplos, escriba: "get-help Start-Sleep -examples". Para obtener ms informacin, escriba: "get-help Start-Sleep -detailed". Para obtener informacin tcnica, escriba: "get-help Start-Sleep -full". NOMBRE Tee-Object SINOPSIS Guarda el resultado de un comando en un archivo o una variable y lo muestra en la consola. SINTAXIS Tee-Object [-FilePath] [-InputObject ] [] Tee-Object -Variable [-InputObject ] [] DESCRIPCIN El cmdlet Tee-Object enva el resultado de un comando en dos direcciones (como la letra "T"). Lo almacena en un archivo o una variable y tambin lo enva a travs de la canalizacin. Si Tee-Object es el ltimo comando en la canalizacin, el resultado del comando se muestra en la consola. PARMETROS -FilePath

Especifica el archivo en el que el cmdlet almacena el objeto. Se permite el uso de caracteres comodn siempre y cuando den lugar a un nico archivo. -InputObject Especifica la entrada de objetos para el cmdlet. Especifique la variable que contiene los objetos o escriba un comando o una expresin que los obtenga. -Variable Asigna a la variable especificada una referencia de los objetos de entrada. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>get-process | tee-object -filepath C:\Test1\testfile2.txt Handles ------83 272 81 81 ... NPM(K) -----4 6 3 4 PM(K) ----2300 1400 804 2008 WS(K) VM(M) ----- ----4520 39 3944 34 3284 21 5808 38 CPU(s) -----0.30 0.06 2.45 0.75 Id -4032 3088 148 3684 ProcessName ----------00THotkey alg ApntEx Apoint

Descripcin ----------Este comando obtiene una lista con los procesos que se ejecutan en el equipo y enva el resultado a un archivo. Dado que no se especifica una segunda ruta, el resultado se mostrar en la consola.

-------------------------- EJEMPLO 2 -------------------------C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles ProcessName ----------notepad notepad notepad notepad Handles ------43 37 38 38

Descripcin ----------Este comando obtiene una lista de los procesos que se ejecutan en el equipo y enva el resultado a una variable denominada "proc". A continuacin, canaliza los objetos resultantes a Select-Object, que selecciona las propiedades ProcessName y Handles. Tenga en cuenta que la variable $proc contie ne la informacin predeterminada devuelta por Get-Process.

NOTAS Para ver los ejemplos, escriba: "get-help Tee-Object -examples". Para obtener ms informacin, escriba: "get-help Tee-Object -detailed". Para obtener informacin tcnica, escriba: "get-help Tee-Object -full". NOMBRE Measure-Command SINOPSIS Mide el tiempo que tardan en ejecutarse los bloques de script y los cmdlets. SINTAXIS Measure-Command [-Expression] [-InputObject ] [] DESCRIPCIN El cmdlet Measure-Command ejecuta un bloque de script o un cmdlet internamente, calcula el tiempo que dura la ejecucin de la operacin y devuelve el tiempo de ejecucin. PARMETROS -Expression Especifica la expresin que se est cronometrando. Escriba la expresin entre llaves ({}). El nombre del parmetro ("Expression") es opcional. -InputObject Especifica los objetos que representan las expresiones que se van a medir. Especifique la variable que contiene los objetos o escriba un comando o una expresin que los obtenga. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>Measure-Command { get-eventlog "windows powershell" } Descripcin ----------Este comando mide el tiempo que tarda la ejecucin de un comando "geteventlog", que obtiene los eventos del registro de eventos de Windows PowerShell.

-------------------------- EJEMPLO 2 -------------------------C:\PS>measure-command {get-childitem c:\windows -include *.txt -recurse}

Days Hours Minutes Seconds Milliseconds Ticks TotalDays TotalHours TotalMinutes TotalSeconds TotalMilliseconds

: : : : : : : : : : :

0 0 0 8 618 86182763 9.9748568287037E-05 0.00239396563888889 0.143637938333333 8.6182763 8618.2763

C:\PS>measure-command {get-childitem c:\windows -filter "*.txt" recurse} Days Hours Minutes Seconds Milliseconds Ticks TotalDays TotalHours TotalMinutes TotalSeconds TotalMilliseconds : : : : : : : : : : : 0 0 0 1 140 11409189 1.32050798611111E-05 0.000316921916666667 0.019015315 1.1409189 1140.9189

Descripcin ----------Estos comandos muestran el valor que resulta de usar un filtro especfico del proveedor en los comandos de Windows PowerShell. El primer comando mide el tiempo que tarda en procesarse un comando Get-ChildItem recursivo que usa el parmetro Include. El segundo comando mide el tiempo que tarda en procesarse un comando Get-ChildItem recursivo que usa el parmetro Filter especfico del proveedor.

NOTAS Para ver los ejemplos, escriba: "get-help Measure-Command -examples". Para obtener ms informacin, escriba: "get-help Measure-Command detailed". Para obtener informacin tcnica, escriba: "get-help Measure-Command full". NOMBRE Import-LocalizedData SINOPSIS Importa los datos especficos del idioma en scripts y funciones segn la referencia cultural de la interfaz de usuario que se haya seleccionado para el sistema operativo. SINTAXIS Import-LocalizedData [-BindingVariable] [[-UICulture] ] [-BaseDirectory ] [-FileName ] [-SupportedCommand ] []

DESCRIPCIN El cmdlet Import-LocalizedData recupera dinmicamente las cadenas de un subdirectorio cuyo nombre coincide con el idioma de la interfaz de usuario del usuario actual del sistema operativo. Este cmdlet se ha diseado para que los scripts puedan mostrar los mensajes de usuario en el idioma que el usuario actual ha seleccionado para la interfaz de usuario. Import-LocalizedData importa los datos de los archivos .psd1 en los subdirectorios especficos del idioma dentro del directorio del script y los guarda en una variable local especificada en el comando. El cmdlet selecciona el subdirectorio y el archivo basndose en el valor de la variable autom tica $PSUICulture. Cuando se usa la variable local en el script para mostrar un mensaje de usuario, dicho mensaje aparece en el idioma de la interfaz de usuario del usuario. Puede utilizar los parmetros de Import-LocalizedData para especificar una referencia cultural de interfaz de usuario, una ruta de acceso y un nombre de archivo diferentes, agregar comandos compatibles y suprimir el mensaje de error que aparece si no se encuentran los archivos .psd1. El cmdlet Import-LocalizedData admite la internacionalizacin de los scripts en Windows PowerShell 2.0. Esta iniciativa tiene como objetivo atender mejor a los usuarios en todo el mundo ya que facilita a los scripts la tarea de mostrar los mensajes de usuario en el idioma de la interfaz de usua rio del usuario actual.Para obtener ms informacin sobre este tema y sobre el formato de los archivos .psd1, vea about_Script_Internationalization. PARMETROS -BaseDirectory Especifica el directorio base donde estn ubicados los archivos .psd1. De forma predeterminada, se trata del directorio donde est ubicado el script. Import-LocalizedData busca el archivo .psd1 para el script en un subdirectorio especfico del idioma dentro del directorio base. -BindingVariable Especifica una variable en la que se importan las cadenas de texto. Escriba un nombre de variable sin el signo de dlar ($). Cuando use Import-LocalizedData para reemplazar las cadenas de texto predeterminadas que se especifican en la seccin de datos de un script, asigne la seccin de datos a una variable y escriba el nombre de dicha variable en el valor del parmetro BindingVariable. A continuacin, cuando Impo rt-LocalizedData guarde el contenido importado en BindingVariable, los datos importados reemplazarn las cadenas de texto predeterminadas. Si no especifica cadenas de texto predeterminadas, podr seleccionar cualquier nombre de variable. -FileName Especifica el nombre del archivo .psd1 que se va a importar. Escriba un nombre de archivo sin la extensin .psd1. El valor predeterminado es el nombre del script. Por ejemplo, si el script es FindFiles.ps1, Import-LocalizedData buscar FindFiles.psd1. Puede utilizar este parmetro para indicar a Import-LocalizedData que busque otro archivo .psd1.

-SupportedCommand Especifica los cmdlets y funciones que solo generan datos. Utilice este parmetro para incluir los cmdlets y funciones que haya escrito o probado. Para obtener ms informacin, vea about_Script_Internationalization. -UICulture Especifica una referencia cultural de interfaz de usuario alternativa. El valor predeterminado es el valor de la variable automtica $PsUICulture. Especifique una referencia cultural de interfaz de usuario con el formato "-", como en-US, de-DE o ar-SA. El valor del parmetro UICulture determina el subdirectorio especfico del idioma (dentro del directorio base) desde el cual ImportLocalizedData obtiene el archivo .psd1 para el script. El cmdlet busca un subdirectorio con el mismo nombre que el valor del parmetro UICulture o la variable automtica $PsUICulture, como "de-DE" o "ar-SA". Si no encuentra el directorio o el directorio no contiene un archivo .psd1 para el script, buscar un subdirectorio con el nombre del cdi go de idioma, como "de" o "ar". Si no encuentra el subdirectorio o el archivo .psd1, el comando generar un error y los datos se mostrarn en el idioma predeterminado especificado en el script. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>import-localizeddata -bindingVariable messages Descripcin ----------Este comando importa cadenas de texto en la variable $messages. Utiliza todos los valores predeterminados para los parmetros del cmdlet. Si se incluye el comando en el script Archives.ps1 del directorio C:\test y el valor de la variable automtica $PsUICulture es zh-CN, ImportLocalizedData importar el archivo Archives.psd1 en el directorio C:\test\zh-CN.

-------------------------- EJEMPLO 2 -------------------------C:\PS>import-localizeddata -bindingVariable msgTbl -uiculture ar-SA filename Simple -baseDirectory C:\Data\Localized Descripcin ----------Este comando importa cadenas de texto en la variable $msgTbl de un script.

Utiliza el parmetro UICulture para indicar al cmdlet que importe los datos del archivo Simple.psd1 en el subdirectorio ar-SA de C:\Data\Localized.

-------------------------- EJEMPLO 3 -------------------------C:\PS># In C:\Test\en-US\test.psd1: ConvertFrom-StringData @' # English strings Msg1 = "The Name parameter is missing from the command." Msg2 = "This command requires the credentials of a member of the Administrators group on the computer." Msg3 = "Use $_ to represent the object that is being processed." '@ # In C:\Test\Test.ps1 import-localizeddata -bindingvariable messages write-host $messages.msg2 # In Windows PowerShell C:\PS> .\test.ps1 This command requires the credentials of a member of the Administrators group on the computer. Descripcin ----------En este ejemplo se muestra cmo utilizar datos localizados en un script simple. En la primera parte del ejemplo se muestra el contenido del archivo Test.psd1. Contiene un comando ConvertFrom-StringData que convierte una serie de cadenas de texto con nombre en una tabla hash. El archivo test.psd1 se encuentra en el subdirectorio en-US del directorio C:\Test que contiene el script. En la segunda parte del ejemplo se muestra el contenido del script Test.ps1. El script contiene un comando Import-LocalizedData que importa los datos del archivo .psd1 correspondiente en la variable $Messages y un comando Write-Host que escribe en el programa host uno de los mensajes almacenado s en la variable $Messages. En la ltima parte del ejemplo, se ejecuta el script. El resultado indica que se muestra el mensaje de usuario correcto en el idioma de la interfaz de usuario del usuario actual del sistema operativo.

-------------------------- EJEMPLO 4 -------------------------C:\PS># In TestScript.ps1 $UserMessages = DATA {

ConvertFrom-StringData @' # English strings Msg1 = "Enter a name." Msg2 = "Enter your employee ID." Msg3 = "Enter your building number." '@ } Import-LocalizedData -bindingVariable UserMessages $UserMessages.Msg1 ... Descripcin ----------En este ejemplo se muestra cmo utilizar Import-LocalizedData para reemplazar las cadenas de texto predeterminadas que estn definidas en la seccin de datos de un script. En este ejemplo, la seccin de datos del script TestScript.ps1 contiene un comando ConvertFrom-StringData que convierte el contenido de la seccin de datos en una tabla hash y la almacena en el valor de la variable $UserMessages. El script tambin incluye un comando Import-LocalizedData, que importa una tabla hash de las cadenas de texto traducidas desde el archivo TestScript.psd1 en el subdirectorio especificado por el valor de la variable $PsUICulture. Si el comando encuentra el archivo .psd1, guardar las cadenas tra ducidas del archivo en el valor de la misma variable $UserMessages, sobrescribiendo la tabla hash guardada por la lgica de la seccin de datos. El tercer comando muestra el primer mensaje almacenado en la variable $UserMessages. Si el comando Import-LocalizedData encuentra un archivo .psd1 para el idioma de $PsUICulture, el valor de la variable $UserMessages contendr las cadenas de texto traducidas. Si por algn motivo el comando genera un error, se mostrarn las cadenas de texto predeterminadas que estn definidas en la seccin de datos del script.

-------------------------- EJEMPLO 5 -------------------------C:\PS># In Day1.ps1 Import-LocalizedData -bindingVariable Day Day.MessageDate # In Day2.ps1 Import-LocalizedData -bindingVariable Day -errorAction:silentlycontinue Day.MessageDate C:\PS> .\Day1.ps1 Import-LocalizedData : Cannot find PowerShell data file 'Day1.psd1' in directory 'C:\ps-test\fr-BE\' or any parent culture directories. At C:\ps-test\Day1.ps1:17 char:21 + Import-LocalizedData $c = get-culture C:\PS> $c | format-list -property * Parent : en LCID : 1033 KeyboardLayoutId : 1033 Name : en-US IetfLanguageTag : en-US DisplayName : English (United States) NativeName : English (United States) EnglishName : English (United States) TwoLetterISOLanguageName : en ThreeLetterISOLanguageName : eng ThreeLetterWindowsLanguageName : ENU CompareInfo : CompareInfo - 1033 TextInfo : TextInfo - 1033 IsNeutralCulture : False CultureTypes : SpecificCultures, InstalledWin32Cultures, FrameworkCultures NumberFormat : System.Globalization.NumberFormatInfo DateTimeFormat : System.Globalization.DateTimeFormatInfo Calendar : System.Globalization.GregorianCalendar OptionalCalendars : {System.Globalization.GregorianCalendar, System.Globalization.GregorianCalendar} UseUserOverride : True IsReadOnly : False C:\PS> $c.calendar MinSupportedDateTime : 1/1/0001 12:00:00 AM MaxSupportedDateTime : 12/31/9999 11:59:59 PM

AlgorithmType CalendarType Eras TwoDigitYearMax IsReadOnly

: : : : :

SolarCalendar Localized {1} 2029 False

C:\PS> $c.datetimeformat AMDesignator : Calendar : System.Globalization.GregorianCalendar DateSeparator : FirstDayOfWeek : CalendarWeekRule : FullDateTimePattern : LongDatePattern : LongTimePattern : MonthDayPattern : PMDesignator : RFC1123Pattern : ShortDatePattern : ShortTimePattern : SortableDateTimePattern : TimeSeparator : UniversalSortableDateTimePattern : YearMonthPattern : AbbreviatedDayNames : ShortestDayNames : DayNames : Wednesday...} AbbreviatedMonthNames : MonthNames : IsReadOnly : NativeCalendarName : AbbreviatedMonthGenitiveNames : MonthGenitiveNames : AM / Sunday FirstDay dddd, MMMM dd, yyyy h:mm:ss tt dddd, MMMM dd, yyyy h:mm:ss tt MMMM dd PM ddd, dd MMM yyyy HH':'mm':'ss 'GMT' M/d/yyyy h:mm tt yyyy'-'MM'-'dd'T'HH':'mm':'ss : yyyy'-'MM'-'dd HH':'mm':'ss'Z' MMMM, yyyy {Sun, Mon, Tue, Wed...} {Su, Mo, Tu, We...} {Sunday, Monday, Tuesday, {Jan, Feb, Mar, Apr...} {January, February, March, April...} False Gregorian Calendar {Jan, Feb, Mar, Apr...} {January, February, March, April...}

C:\PS> $c.datetimeformat.firstdayofweek Sunday Descripcin ----------En este ejemplo se muestra la gran cantidad de datos en el objeto de referencia cultural. Se indica cmo mostrar las propiedades y subpropiedades del objeto. El primer comando utiliza el cmdlet Get-Culture para obtener la configuracin de la actual referencia cultural en el equipo local. Almacena el objeto de referencia cultural resultante en la variable Sc. El segundo comando muestra todas las propiedades del referencia cultural. Utiliza un operador de canalizacin objeto de referencia cultural almacenado en $c al cmdlet Utiliza el parmetro Property para mostrar todas (*) las objeto. (Este comando se puede abreviar como "$c | fl *".) objeto de (|) para enviar el Format-List. propiedades del

Los comandos restantes exploran las propiedades del objeto de referencia cultural utilizando la notacin de puntos para mostrar los valores de las propiedades del objeto. Esta notacin puede usarse para mostrar el valor de cualquier propiedad del objeto. El tercer comando usa la notacin de puntos para mostrar el valor de la propiedad Calendar del objeto de referencia cultural. El cuarto comando usa la notacin de puntos para mostrar el valor de la propiedad DateTimeFormat del objeto de referencia cultural. Muchas propiedades de objeto tienen propiedades. El quinto comando utiliza la notacin de puntos para mostrar el valor de la propiedad FirstDayOfWeek de la propiedad DateTimeFormat.

NOTAS Para ver los ejemplos, escriba: "get-help Get-Culture -examples". Para obtener ms informacin, escriba: "get-help Get-Culture -detailed". Para obtener informacin tcnica, escriba: "get-help Get-Culture -full". NOMBRE Get-Date SINOPSIS Obtiene la fecha y hora actuales. SINTAXIS Get-Date [-Format ] [[-Date] ] [-Day ] [DisplayHint {Date | Time | DateTime}] [-Hour ] [-Minute ] [-Month ] [-Second ] [-Year ] [] Get-Date [-UFormat ] [[-Date] ] [-Day ] [DisplayHint {Date | Time | DateTime}] [-Hour ] [-Minute ] [-Month ] [-Second ] [-Year ] [] DESCRIPCIN El cmdlet Get-Date obtiene un objeto DateTime que representa la fecha actual o una fecha especificada. Puede aplicar a la fecha y la hora varios formatos de Windows y UNIX. Puede utilizar Get-Date para generar una cadena de caracteres de fecha u hora y, a continuacin, enviarla a otros cmdlets o programas. PARMETROS -Date Especifica una fecha y hora. De manera predeterminada, Get-Date obtiene la fecha y la hora actuales del sistema. Escriba la fecha en un formato que sea estndar para la configuracin regional del sistema, como dd-MM-aaaa (alemn [Alemania]) o MM/dd/aaaa (ingls [Estados Unidos]). -Day Especifica el da del mes que se va a mostrar. Escriba un valor comprendido entre 1 y 31. Este valor se muestra en lugar del da actual.

Si se especifica un valor superior al nmero de das del mes, Windows PowerShell suma el nmero de das al mes y muestra el resultado. Por ejemplo, "get-date -month 2 -day 31" mostrar "March 3", y no "February 31". -DisplayHint Determina qu elementos de fecha y hora se muestran. Los valores vlidos son: -- Date: muestra solo la fecha -- Time: muestra solo la hora -- DateTime: muestra la fecha y la hora DateTime es el valor predeterminado. Este parmetro no afecta al objeto DateTime que Get-Date recupera. -Format Muestra la fecha y la hora en el formato de Microsoft .NET Framework indicado por el especificador de formato. Escriba un especificador de formato. Para obtener una lista de los especificadores de formato disponibles, vea la clase DateTimeFormatInfo en MSDN (Microsoft Developer Network) Lib rary, en http://go.microsoft.com/fwlink/?LinkId=143638. Cuando se usa el parmetro Format, Windows PowerShell recupera nicamente las propiedades del objeto DateTime que necesita para mostrar la fecha en el formato especificado. Por tanto, es posible que algunos mtodos y propiedades de los objetos DateTime no estn disponibles. -Hour Especifica la hora que se va a mostrar. Escriba un valor comprendido entre 1 y 23. Este valor se muestra en lugar de la hora actual. -Minute Especifica el minuto que se va a mostrar. Escriba un valor comprendido entre 1 y 59. Este valor se muestra en lugar del minuto actual. -Month Especifica el mes que se va a mostrar. Escriba un valor comprendido entre 1 y 12. Este valor se muestra en lugar del mes actual. -Second Especifica el segundo que se va a mostrar. Escriba un valor comprendido entre 1 y 59. Este valor se muestra en lugar del segundo actual. -UFormat Muestra la fecha y la hora en formato UNIX. Para obtener una lista de los especificadores de formato, vea la seccin Notas. Cuando se usa el parmetro UFormat, Windows PowerShell recupera nicamente las propiedades del objeto DateTime que necesita para mostrar la fecha en el formato especificado. Por tanto, es posible que algunos mtodos y propiedades de los objetos DateTime no estn disponibles. -Year Especifica el ao que se va a mostrar. Escriba un valor comprendido entre 1 y 9999. Este valor se muestra en lugar del ao actual. Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>get-date -DisplayHint date Tuesday, June 13, 2006 Descripcin ----------Este comando recupera un objeto DateTime, pero muestra nicamente la fecha. Usa el parmetro DisplayHint para indicar que solo debe mostrarse la fecha.

-------------------------- EJEMPLO 2 -------------------------C:\PS>get-date -format g 6/13/2006 12:43 PM Descripcin ----------Este comando recupera la fecha y la hora actuales y les aplica el formato corto. Usa el especificador de formato "g" de .NET Framework (General [fecha y hora cortas]) para especificar el formato.

-------------------------- EJEMPLO 3 -------------------------C:\PS>get-date -uformat "%Y / %m / %d / %A / %Z" 2006 / 06 / 13 / Tuesday / -07 Descripcin ----------Este comando recupera la fecha y la formato especificado por el comando. En completo (%Y), el nmero de mes con dos completo de la semana (%A) y el desfase

hora actuales y les aplica el este caso, el formato incluye el ao dgitos (%m), la fecha (%d), el da horario respecto a UTC ("Zulu").

-------------------------- EJEMPLO 4 -------------------------C:\PS>(get-date -year 2000 -month 12 -day 31).dayofyear 366 Descripcin ----------Este comando muestra el da del ao de la fecha actual. Por ejemplo, el 31 de diciembre es el da 365 del ao 2006, pero es el da 366 del ao 2000.

-------------------------- EJEMPLO 5 -------------------------C:\PS>$a = get-date C:\PS> $a.IsDaylightSavingTime() True Descripcin ----------Estos comandos indican si la fecha y hora actuales se han ajustado al cambio de horario de verano o invierno en la configuracin local. El primer comando crea una variable denominada $a y, a continuacin, asigna a esta variable el objeto recuperado por Get-Date. A continuacin, aplica el mtodo IsDaylightSavingTime al objeto guardado en $a. Para ver los mtodos y propiedades del objeto DateTime, escriba: "get-date | get-member".

-------------------------- EJEMPLO 6 -------------------------C:\PS>$a = get-date C:\PS> $a.ToUniversalTime() Tuesday, June 13, 2006 8:09:19 PM Descripcin ----------Estos comandos transforman la fecha y hora actual en la hora UTC. El primer comando crea una variable denominada $a y, a continuacin, asigna a esta variable el objeto recuperado por Get-Date. A continuacin, aplica el mtodo ToUniversalTime al objeto guardado en $a.

-------------------------- EJEMPLO 7 -------------------------C:\PS>$a = get-wmiobject win32_bios -computer server01 $a | format-list -property Name, @{Label="BIOS Age"; ` Expression={(get-date) - $_.ConvertToDateTime($_.ReleaseDate)}} Name : Default System BIOS BIOS Age : 1345.17:31:07.1091047 Descripcin ----------Instrumental de administracin de Windows (WMI) usa un objeto date-time diferente al objeto date-time de .NET Framework que Get-Date devuelve. Para usar la informacin del objeto date-time de WMI en un comando con informacin del objeto date-time de Get-Date, debe usar el mtodo ConvertToDateTi

me para convertir los objetos CIM_DATETIME de WMI en objetos DateTime de .NET Framework. Los comandos de este ejemplo muestran el nombre y la antigedad del BIOS en el equipo remoto Server01. El primer comando utiliza el cmdlet Get-WmiObject para obtener una instancia de la clase Win32_BIOS en Server01 y, a continuacin, la almacena en la variable $a. El segundo comando usa el operador de canalizacin (|) para enviar el objeto de WMI almacenado en $a al cmdlet Format-List. El parmetro Property de Format-List se usa para especificar las dos propiedades que se van a mostrar en la lista, "Name" y "BIOS Age". La propiedad "BIOS Age" se especifi ca en una tabla hash. La tabla contiene la clave Label, que especifica el nombre de la propiedad, y la clave Expression, que contiene la expresin que calcula la antigedad del BIOS. La expresin usa el mtodo ConvertToDateTime para convertir cada instancia de ReleaseDate en un objeto DateTime de .NET Framework. A continuacin, el valor se resta del valor del cmdlet Get-Date, que, sin parmetros, obtiene la fecha actual. El carcter de acento grave (`) es el carcter de continuacin de lnea en Windows PowerShell.

-------------------------- EJEMPLO 8 -------------------------C:\PS>get-date Tuesday, June 13, 2006 12:43:42 PM Descripcin ----------Este comando obtiene un objeto DateTime y muestra la fecha y la hora actuales en formato largo para la configuracin regional del sistema, como si se escribiera "get-date -format F".

-------------------------- EJEMPLO 9 -------------------------C:\PS>get-date C:\PS> Tuesday, September 26, 2006 11:25:31 AM c:\PS>(get-date).ToString() 9/26/2006 11:25:31 AM C:\PS>get-date | add-content test.txt # Adds 9/26/2006 11:25:31 AM C:\PS>get-date -format F | add-content test.txt # Adds Tuesday, September 26, 2006 11:25:31 AM Descripcin -----------

Estos comandos muestran cmo utilizar Get-Date con Add-Content y otros cmdlets que convierten el objeto DateTime generado por Get-Date en una cadena. El primer comando muestra que el formato de presentacin predeterminado del comando "get-date" es el formato de fecha larga y hora larga. El segundo comando muestra que el formato de presentacin predeterminado del mtodo ToString() del objeto DateTime es el formato de fecha corta y hora corta. El tercer comando usa un operador de canalizacin para enviar el objeto DateTime al cmdlet Add-Content, que agrega el contenido al archivo Test.txt. Dado que Add-Content utiliza el mtodo ToString() del objeto DateTime, la fecha que se agrega tiene el formato de fecha corta y hora corta. El cuarto comando utiliza el parmetro Format de Get-Date para especificar el formato. Cuando se utiliza el parmetro Format o UFormat, Get-Date genera una cadena en lugar de un objeto DateTime. A continuacin, cuando se enva la cadena a Add-Content, se agrega al archivo Test.txt sin que se re alice cambio alguno.

NOTAS Para ver los ejemplos, escriba: "get-help Get-Date -examples". Para obtener ms informacin, escriba: "get-help Get-Date -detailed". Para obtener informacin tcnica, escriba: "get-help Get-Date -full". NOMBRE Get-Host SINOPSIS Obtiene un objeto que representa el actual programa host. Adems, de manera predeterminada, muestra la versin y la informacin regional de Windows PowerShell. SINTAXIS Get-Host [] DESCRIPCIN El cmdlet Get-Host obtiene un objeto que representa el programa que hospeda Windows PowerShell. De forma predeterminada, se muestran el nmero de versin de Windows PowerShell as como la actual configuracin regional y de idioma que el host utiliza. Sin embargo, el objeto de host contiene una gran cantidad de informacin, como informacin detallada sobre la versin de Windows PowerShell que se est ejecutando, la actual referencia cultural y la referencia cultural de la interfaz de usuario de Windows PowerShell. Este cmdlet puede usarse asimismo para personalizar las caractersticas de la interfaz de usuario del programa host, como los colores de texto y de fondo. PARMETROS

Este cmdlet admite los parmetros comunes Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer y OutVariable. Para obtener ms informacin, escriba: "get-help about_commonparameters". -------------------------- EJEMPLO 1 -------------------------C:\PS>get-host Name : ConsoleHost Version : 2.0 InstanceId : e4e0ab54-cc5e-4261-9117-4081f20ce7a2 UI : System.Management.Automation.Internal.Host.InternalHostUserInterface CurrentCulture : en-US CurrentUICulture : en-US PrivateData : Microsoft.PowerShell.ConsoleHost+ConsoleColorProxy IsRunspacePushed : False Runspace : System.Management.Automation.Runspaces.LocalRunspace Descripcin ----------Este comando muestra informacin sobre la consola de Windows PowerShell, que es el programa que hospeda Windows PowerShell en este ejemplo. Incluye el nombre del host, la versin de Windows PowerShell que se est ejecutando en el host as como la actual referencia cultural y la referencia cultu ral de la interfaz de usuario. Las propiedades Version, UI, CurrentCulture, CurrentUICulture, PrivateData y Runspace contienen un objeto con propiedades muy tiles. Estas propiedades se examinarn ms adelante en ejemplos.

-------------------------- EJEMPLO 2 -------------------------C:\PS>$h = get-host C:\PS> $win = $h.ui.rawui.windowsize C:\PS> $win.height = 10 C:\PS> $win.width = 10

C:\PS> $h.ui.rawui.set_windowsize($win) Descripcin ----------Este comando cambia el tamao de la ventana de Windows PowerShell a 10 x 10 pxeles.

-------------------------- EJEMPLO 3 -------------------------C:\PS>(get-host).version | format-list -property * Major Minor : 2 : 0

Build Revision MajorRevision MinorRevision

: : : :

-1 -1 -1 -1

Descripcin ----------Este comando obtiene informacin detallada sobre la versin de Windows PowerShell que se ejecuta en el host. Estos valores se pueden ver pero no cambiar. La propiedad Version de Get-Host contiene un objeto System.Version. Este comando utiliza un operador de canalizacin (|) para enviar el objeto de versin al cmdlet Format-List. El comando Format-List usa el parmetro Property con un asterisco (*) para mostrar todas las propiedades y valores de propiedad del objeto de versin.

-------------------------- EJEMPLO 4 -------------------------C:\PS>(get-host).currentculture | format-list -property * Parent : en LCID : 1033 KeyboardLayoutId : 1033 Name : en-US IetfLanguageTag : en-US DisplayName : English (United States) NativeName : English (United States) EnglishName : English (United States) TwoLetterISOLanguageName : en ThreeLetterISOLanguageName : eng ThreeLetterWindowsLanguageName : ENU CompareInfo : CompareInfo - 1033 TextInfo : TextInfo - 1033 IsNeutralCulture : False CultureTypes : SpecificCultures, InstalledWin32Cultures, FrameworkCultures NumberFormat : System.Globalization.NumberFormatInfo DateTimeFormat : System.Globalization.DateTimeFormatInfo Calendar : System.Globalization.GregorianCalendar OptionalCalendars : {System.Globalization.GregorianCalendar, System.Globalization.GregorianCalendar} UseUserOverride : True IsReadOnly : False Descripcin ----------Este comando obtiene informacin detallada sobre la actual referencia cultural establecida para la instancia de Windows PowerShell que se ejecuta en el host. Se trata de la misma informacin que el cmdlet Get-Culture devuelve. (De forma similar, la propiedad CurrentUICulture devuelve el mismo objeto que Get-UICulture.)

La propiedad CurrentCulture del objeto de host contiene un objeto System.Globalization.CultureInfo. Este comando utiliza un operador de canalizacin (|) para enviar el objeto CultureInfo al cmdlet Format-List. El comando Format-List usa el parmetro Property con un asterisco (*) para mostrar to das las propiedades y valores de propiedad del objeto CultureInfo.

-------------------------- EJEMPLO 5 -------------------------C:\PS>(get-host).currentculture.DateTimeFormat | format-list -property * AMDesignator : Calendar : System.Globalization.GregorianCalendar DateSeparator : FirstDayOfWeek : CalendarWeekRule : FullDateTimePattern : LongDatePattern : LongTimePattern : MonthDayPattern : PMDesignator : RFC1123Pattern : ShortDatePattern : ShortTimePattern : SortableDateTimePattern : TimeSeparator : UniversalSortableDateTimePattern : YearMonthPattern : AbbreviatedDayNames : ShortestDayNames : DayNames : Wednesday...} AbbreviatedMonthNames : MonthNames : IsReadOnly : NativeCalendarName : AbbreviatedMonthGenitiveNames : MonthGenitiveNames : AM / Sunday FirstDay dddd, MMMM dd, yyyy h:mm:ss tt dddd, MMMM dd, yyyy h:mm:ss tt MMMM dd PM ddd, dd MMM yyyy HH':'mm':'ss 'GMT' M/d/yyyy h:mm tt yyyy'-'MM'-'dd'T'HH':'mm':'ss : yyyy'-'MM'-'dd HH':'mm':'ss'Z' MMMM, yyyy {Sun, Mon, Tue, Wed...} {Su, Mo, Tu, We...} {Sunday, Monday, Tuesday, {Jan, Feb, Mar, Apr...} {January, February, March, April...} False Gregorian Calendar {Jan, Feb, Mar, Apr...} {January, February, March, April...}

Descripcin ----------Este comando devuelve informacin detallada sobre la propiedad DateTimeFormat de la actual referencia cultural que se utiliza para Windows PowerShell. La propiedad CurrentCulture del objeto de host contiene un objeto CultureInfo que, a su vez, tiene muchas propiedades tiles. Entre ellas, la propiedad DateTimeFormat contiene un objeto DateTimeFormatInfo con muchas propiedades tiles. Para obtener el tipo de un objeto almacenado en una propiedad de objeto, utilice el cmdlet Get-Member. Para mostrar los valores de propiedad del objeto, utilice el cmdlet Format-List.

-------------------------- EJEMPLO 6 -------------------------C:\PS>(get-host).ui.rawui | format-list -property * ForegroundColor BackgroundColor CursorPosition WindowPosition CursorSize BufferSize WindowSize MaxWindowSize MaxPhysicalWindowSize KeyAvailable WindowTitle : : : : : : : : : : : DarkYellow DarkBlue 0,390 0,341 25 120,3000 120,50 120,81 182,81 False Windows PowerShell 2.0 (04/11/2008 00:08:14)

Descripcin ----------Este comando muestra las propiedades de la propiedad RawUI del objeto de host. Al cambiar estos valores, se puede cambiar la apariencia del programa host.

-------------------------- EJEMPLO 7 -------------------------C:\PS>(get-host).ui.rawui.backgroundcolor = "Black" C:\PS> cls Descripcin ----------Estos comandos cambian a negro el color de fondo de la consola de Windows PowerShell. El comando "cls" es un alias de la funcin Clear-Host, que borra la pantalla y cambia el color de toda la pantalla al nuevo color. Este cambio solo surte efecto en la sesin actual. Si desea cambiar el color de fondo de la consola para todas las sesiones, agregue el comando a su perfil de Windows PowerShell.

-------------------------- EJEMPLO 8 -------------------------C:\PS>$host.privatedata.errorbackgroundcolor = "white" Descripcin ----------Este comando cambia a blanco el color de fondo de los mensajes de error. Este comando utiliza la variable automtica $host, que contiene el objeto de host del actual programa host. Get-Host devuelve el mismo objeto que el que contiene $host, de modo que se pueden usar esos objetos indistintamente. Este comando utiliza la propiedad PrivateData de $host como su propiedad ErrorBackgroundColor. Para ver todas las propiedades del objeto en la propiedad $host.privatedata, escriba "$host.privatedata | format-list * ".

NOTAS Para ver los ejemplos, escriba: "get-help Get-Host -examples". Para obtener ms informacin, escriba: "get-help Get-Host -detailed". Para obtener informacin tcnica, escriba: "get-help Get-Host -full". NOMBRE Export-Alias SINOPSIS Exporta a un archivo la informacin sobre los alias actualmente definidos. SINTAXIS Export-Alias [-Path] [[-Name] ] [-Append] [-As {Csv | Script}] [-Description ] [-Force] [-NoClobber] [-PassThru] [-Scope ] [-Confirm] [-WhatIf] [] DESCRIPCIN El cmdlet Export-Alias exporta los alias de la sesin actual a un archivo. Si el archivo de salida no existe, el cmdlet lo crear. Export-Alias puede exportar los alias de un mbito determinado o todos los mbitos y puede generar los datos en formato CSV o como una serie de comandos Set-Alias que se pueden agregar a una sesin o un perfil de Windows PowerShell. PARMETROS -Append [] Anexa el resultado al archivo especificado, en lugar de sobrescribir el contenido existente del archivo. -As Determina el formato de los resultados. El valor predeterminado es CSV. Los valores vlidos son: -- CSV: formato de valores separados por comas (CSV). -- Script: crea un comando Set-Alias para cada alias exportado. Si asigna al nombre del archivo de salida la extensin .ps1, podr ejecutarlo como un script para agregar los alias a cualquier sesin. -Description Agrega una descripcin al archivo exportado. La descripcin aparece como un comentario en la parte superior del archivo tras la informacin del encabezado. -Force [] Sobrescribe el archivo de salida, incluso si est establecido el atributo de solo lectura en el archivo. De forma predeterminada, Export-Alias sobrescribe los archivos sin avisar, a menos que est establecido el atributo de solo lectura u oculto o se utilice el parmetro NoClobber en el comando. El parmetro NoClobber tiene precedencia sobre el parmetro Force cuando se utilizan ambos en un co

mando. El parmetro Force no puede obligar a Export-Alias a sobrescribir los archivos que tengan establecido el atributo oculto. -Name Especifica los nombres de los alias que se van a exportar. Se permite el uso de caracteres comodn. De forma predeterminada, Export-Alias exporta todos los alias de la sesin o del mbito. -NoClobber [] Evita que Export-Alias sobrescriba los archivos, incluso si se usa el parmetro Force en el comando. Si se omite el parmetro NoClobber, Export-Alias sobrescribir un archi