Documentos de Académico
Documentos de Profesional
Documentos de Cultura
About Scripts - Help
About Scripts - Help
about_Scripts
DESCRIPCIN BREVE
Describe como se escriben y ejecutan scripts en Windows PowerShell.
DESCRIPCIN DETALLADA
Un script es un archivo de texto sin formato que contiene uno o
varios comandos de Windows PowerShell. Los scripts de Windows
PowerShell tiene la extensin .ps1.
Al escribir un script, se guarda un comando para utilizarlo
posteriormente y se facilita su uso compartido con otros
usuarios. Y lo que es ms importante, un script permite ejecutar
los comandos escribiendo simplemente su ruta de acceso y nombre
de archivo. Los scripts pueden ser tan simples como un solo
comando en un archivo o tan extensos como un programa complejo.
Los scripts tienen caractersticas adicionales, como el
comentario especial #Requires, el uso de parmetros, la
compatibilidad con secciones de datos y firmas digitales por
motivos de seguridad. Asimismo, se pueden escribir temas de Ayuda
para los scripts y para cualquier funcin en los scripts.
CMO ESCRIBIR UN SCRIPT
Un script puede contener cualquier comando vlido de Windows
PowerShell, como un solo comando, comandos que usan la
canalizacin, funciones y estructuras de control, como
instrucciones If y bucles For.
Para escribir un script, inicie un editor de texto, como Bloc de
notas, o un editor de scripts, como Entorno de scripting
integrado (ISE) de Windows PowerShell. Escriba los comandos y
gurdelos en un archivo con un nombre de archivo vlido y la
extensin .ps1.
El ejemplo siguiente es un script simple que obtiene los
servicios que se estn ejecutando en el sistema actual y los
guarda en un archivo de registro. El nombre del archivo de
registro se crea a partir de la fecha actual.
$date = (get-date).dayofyear
get-service | out-file "$date.log"
Para crear este script, abra un editor de texto o un editor de
scripts, escriba estos comandos y, a continuacin, gurdelos en un archivo denom
inado
"registroDeServicios.ps1".
CMO EJECUTAR UN SCRIPT
Para poder ejecutar un script, deber cambiar la directiva de
ejecucin predeterminada de Windows PowerShell. La directiva de
ejecucin predeterminada, "Restricted", evita la ejecucin de
todos los scripts, incluidos los que se escriben en el equipo
local. Para obtener ms informacin, vea about_Execution_Policies.
Para ejecutar un script, escriba el nombre completo y la ruta de
como para
la Ayuda para
y el
script
function New-Profile
{
Write-Host "Se est ejecutando la funcin New-Profile"
$profileName = split-path $profile -leaf
if (test-path $profile)
{write-error "Ya hay un perfil $profileName en este equipo."}
else
{new-item -type file -path $profile -force }
}
Si se ejecuta el script funcionesDeUtilidad.ps1 en su propio
mbito, la funcin New-Profile y la variable $ProfileName solo
existen durante la ejecucin del script. Cuando se cierra el
script, se quitan la funcin y la variable, tal y como se muestra
en el ejemplo siguiente.
C:\PS> .\funcionesDeUtilidad.ps1
C:\PS> New-Profile
El trmino 'new-profile' no se reconoce como cmdlet, funcin,
programa ejecutable ni archivo de script. Compruebe el
trmino e intntelo de nuevo.
En lnea:1 carcter:12
+ new-profile <<<<
+ CategoryInfo
: ObjectNotFound: (new-profile:String) [],
+ FullyQualifiedErrorId : CommandNotFoundException
C:\PS> $profileName
C:\PS>
Si usa y ejecuta el script prefijado por punto, el script crea la
funcin New-Profile y la variable $ProfileName en su sesin en su
mbito. Despus de ejecutar el script, puede usar la funcin New-Profile
en su sesin, tal y como se muestra en el ejemplo siguiente.
C:\PS> . .\funcionesDeUtilidad.ps1
C:\PS> New-Profile
Directory: C:\Users\juneb\Documents\WindowsPowerShell
Mode
----a---
LastWriteTime
Length Name
------------------ ---1/14/2009 3:08 p. m.
0 Microsoft.PowerShellISE_profile.p
s1
C:\PS> $profileName
Microsoft.PowerShellISE_profile.ps1
Para obtener ms informacin sobre los mbitos, vea about_Scopes.
SCRIPTS EN MDULOS
Un mdulo es un conjunto de recursos relacionados de Windows
PowerShell que se pueden distribuir como una unidad. Puede usar
mdulos para organizar los scripts, funciones y otros recursos.
Tambin puede utilizarlos para distribuir cdigo a otros usuarios
y obtener cdigo de orgenes de confianza.
Puede incluir scripts en los mdulos o crear un mdulo de script,
que es un mdulo que se compone completamente o principalmente de
un script y recursos auxiliares. Un mdulo de script es
simplemente un script con la extensin .psm1.
Para obtener ms informacin sobre los mdulos, vea about_Modules.
VEA TAMBIN
about_Command_Precedence
about_Comment_Based_Help
about_Execution_Policies
about_Functions
about_Modules
about_Profiles
about_Requires
about_Scopes
about_Script_Blocks
about_Signing
Invoke-Command