Merge pull request #39 from MilestoneSystemsInc/Spanish-Translations

github documentation [Spanish translation]

Author: joshooaj

CODE_OF_CONDUCT - sp-MX.md

@@ -0,0 +1,52 @@
+# Código de conducta del pacto del colaborador
+
+## Nuestro compromiso
+
+Con el interés de fomentar un entorno abierto y acogedor, nosotros, como contribuyentes y mantenedores, nos comprometemos a hacer de la participación en nuestro proyecto y nuestra comunidad una experiencia libre de acoso para todos, independientemente de su edad, tamaño corporal, discapacidad, etnia, identidad y expresión de género, nivel de experiencia, nacionalidad, apariencia personal, raza, religión, identidad y orientación sexual, o inclinaciones sexuales entre adultos que consienten.
+
+## Nuestros estándares
+
+Ejemplos de comportamiento que contribuye a crear un entorno positivo.
+incluir:
+
+* Usar un lenguaje acogedor e inclusivo
+* Ser respetuoso con los diferentes puntos de vista y experiencias.
+* Aceptando con gracia las críticas constructivas
+* Centrarse en lo que es mejor para la comunidad
+* Mostrar empatía hacia otros miembros de la comunidad.
+
+Ejemplos de comportamiento inaceptable por parte de los participantes incluyen:
+
+* El uso de lenguaje o imágenes sexualizadas y atención o insinuaciones sexuales no deseadas.
+* Trolking, comentarios insultantes / despectivos y ataques personales o políticos.
+* Acoso público o privado
+* Publicar información privada de otros, como una información física o electrónica.
+  dirección, sin permiso explícito
+* Otra conducta que razonablemente podría considerarse inapropiada en un
+  entorno profesional
+
+## Nuestras responsabilidades
+
+Los encargados del mantenimiento del proyecto son responsables de aclarar los estándares de comportamiento aceptable y se espera que tomen las medidas correctivas adecuadas y justas en respuesta a cualquier caso de comportamiento inaceptable.
+
+Los encargados del mantenimiento del proyecto tienen el derecho y la responsabilidad de eliminar, editar o rechazar comentarios, confirmaciones, códigos, ediciones de wiki, problemas y otras contribuciones que no estén alineadas con este Código de Conducta, o prohibir temporal o permanentemente a cualquier colaborador por otros comportamientos que lo consideran inapropiado, amenazante, ofensivo o dañino.
+
+## Alcance
+
+Este Código de Conducta se aplica tanto dentro de los espacios del proyecto como en los espacios públicos cuando una persona representa el proyecto o su comunidad. Ejemplos de representación de un proyecto o comunidad incluyen el uso de una dirección de correo electrónico oficial del proyecto, la publicación a través de una cuenta oficial de redes sociales o la actuación como representante designado en un evento en línea o fuera de línea. Los encargados del mantenimiento del proyecto pueden definir y aclarar más la representación de un proyecto.
+
+## Ejecución
+
+Los casos de comportamiento abusivo, acosador o inaceptable de otro modo pueden informarse comunicándose con el equipo del proyecto en [jh@milestone.us] (mailto: jh@milestone.us). Todas las quejas serán revisadas e investigadas y resultarán en una respuesta que
+se considera necesario y apropiado a las circunstancias. El equipo del proyecto está obligado a mantener la confidencialidad con respecto al informante de un incidente.
+
+Se pueden publicar más detalles de las políticas de aplicación específicas por separado.
+
+Los mantenedores del proyecto que no sigan o hagan cumplir el Código de Conducta de buena fe pueden enfrentar repercusiones temporales o permanentes según lo determinen otros miembros del liderazgo del proyecto.
+
+## Atribución
+
+Este Código de conducta está adaptado del [Pacto del colaborador] [página de inicio], versión 1.4.1, disponible en [http://contributor-covenant.org/version/1/4/1][version]
+
+[página de inicio]: http://contributor-covenant.org
+[versión]: http://contributor-covenant.org/version/1/4/

Getting-Started/00-PowerShell-or-ISE - sp-MX.md

@@ -0,0 +1,80 @@
+# PowerShell o ISE?
+
+En un sistema operativo Windows estándar, normalmente tiene dos opciones para usar PowerShell. Tiene más opciones si considera las variantes x86 (32 bits). Cuando está comenzando, puede ser difícil saber cuál usar y porqué. Cuando hace clic en el botón del menú Inicio o presiona su tecla de Windows (<kbd>⊞</kbd>), y escribe "powershell", esto es lo que obtiene...
+
+![Captura de pantalla del menú Inicio que muestra PowerShell](https://github.com/MilestoneSystemsInc/PowerShellSamples/blob/main/Getting-Started/images/Start-Menu.png?raw=true)
+
+## PowerShell de Windows
+
+Esta es su opción de acceso para ingresar un comando a la vez para realizar una tarea simple y única. No es ideal para escribir secuencias de comandos más largos y complejas, ya que cada vez que presione <kbd>Enter</kbd> evaluará lo que ha escrito y lo ejecutará. A menudo uso el terminal de Windows PowerShell para ejecutar comandos individuales como `ping`, y `Test-NetConnection`, o en ocasiones para tareas únicas que requieren varios comandos que me siento cómodo ejecutando en una terminal en lugar de un editor como ISE.
+
+![Captura de pantalla de Windows PowerShell](https://github.com/MilestoneSystemsInc/PowerShellSamples/blob/main/Getting-Started/images/Windows-PowerShell.png?raw=true)
+
+## Windows PowerShell ISE
+
+El Entorno de Scripting Integrado (ISE) PowerShell se incluye en todas las versiones de Windows y proporciona un entorno fácil de usar para escribir scripts en un editor de texto y ejecutar esas secuencias de comandos en la misma interfaz. Aquí es donde desea estar si desea crear una secuencia de comandos de PowerShell. Puede utilizar el Bloc de notas para escribir un archivo .PS1, pero PowerShell ISE ofrece tabulación completa e "Intellisense". Intellisense es como un compañero de desarrollador que conoce todos los parámetros disponibles para cualquier comando que esté escribiendo, por lo que tan pronto como escriba "-" después de `Get-ChildItem` le mostrará todos los parámetros disponibles.
+
+También puede ejecutar una o más líneas de código a la vez con <kbd>F8</kbd> o ejecutar todo el archivo con <kbd>F5</kbd>. Cuando se sienta cómodo con PowerShell como lenguaje y el entorno ISE, incluso puede agregar puntos de interrupción y *depurar* sus secuencias de comandos cuando lo hagan de forma inesperada.
+
+Hay mejores entornos para escribir código de PowerShell que el ISE. Por ejemplo, Visual Studio Code es un editor *gratuito* de Microsoft con extensiones para PowerShell que lo convierten en un entorno mucho más productivo para proyectos de PowerShell más grandes. Sin embargo, el ISE está disponible en *todos* los equipos con Windows y ofrece el punto de partida menos intimidante para la ruta de aprendizaje de PowerShell.
+
+![Captura de pantalla de PowerShell ISE](https://github.com/MilestoneSystemsInc/PowerShellSamples/blob/main/Getting-Started/images/PowerShell-ISE.png?raw=true)
+
+## Windows PowerShell (x86) y Windows PowerShell ISE (x86)
+
+Estos son los equivalentes de 32 bits de los mismos dos entornos de PowerShell ya mencionados. Los entornos estándar de PowerShell son de 64 bits y rara vez necesitará un entorno de 32 bits, pero si lo necesita, lo tiene. Puesto que el MIP SDK de Milestone se proporciona principalmente como paquetes NuGet de 64 bits y el MIP SDK de 32 bits está en desuso, necesitará un entorno Windows PowerShell 5.1 de 64 bits para usar el módulo MilestonePSTools PowerShell.
+
+## Visual Studio Code
+
+VSCode de Microsoft es un entorno fantástico para trabajar en muchos tipos de proyectos, desde PowerShell hasta HTML/CSS/JavaScript, Python y más. Es un editor de texto con extensiones que lo convierten en un entorno cómodo para trabajar con múltiples archivos de diferentes tipos, e incluso ejecutar código. Es una parte integral del mantenimiento de MilestonePSTools y otros proyectos de PowerShell en los que hemos trabajado y, a medida que se sienta más cómodo con PowerShell, le recomiendo que lo pruebe. La siguiente secuencia de comandos automatizará la instalación de código, así como mis extensiones favoritas para trabajar con PowerShell y GitHub.
+
+![Captura de pantalla de Visual Studio Code](https://github.com/MilestoneSystemsInc/PowerShellSamples/blob/main/Getting-Started/images/VSCode.png?raw=true)
+
+```powershell
+$InformationPreference = 'Continue'
+$requestParams = @{
+    Uri = "https://code.visualstudio.com/sha/download?build=stable&os=win32-x64"
+    OutFile = Join-Path $env:TEMP VSCodeUserSetup.exe
+}
+Write-Information "Downloading VSCode from $($requestParams.Uri)"
+Invoke-WebRequest @requestParams
+
+if (-not (Test-Path -Path $requestParams.OutFile)) {
+    throw "Could not find the downloaded installer at $($requestParams.OutFile)"
+}
+
+Write-Information 'Installing VSCode from $($requestParams.OutFile). . .'
+$installerArgs = @{
+    FilePath = $requestParams.OutFile
+    Wait = $true
+    NoNewWindow = $true
+    PassThru = $true
+    ErrorAction = 'Stop'
+    ArgumentList = @(
+    '/verysilent',
+    '/suppressmsgboxes',
+    '/mergetasks="!runCode, desktopicon, quicklaunchicon, addcontextmenufiles, addcontextmenufolders, associatewithfiles, addtopath"'
+    )
+}
+$result = Start-Process @installerArgs
+Remove-Item -Path $requestParams.OutFile -Force
+if ($result.ExitCode -notin @(0, 1641, 3010)) {
+    throw "VSCode installer exited with code $($result.ExitCode)"
+}
+$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+Write-Information "Success! VSCode version $(code --version)"
+
+Write-Information "Installing a couple important VSCode extensions. Some other fun ones include Rainbow Brackets, indent-rainbox, Live Share*, and markdownlint."
+$extensions = @(
+
+)
+$extensions = @(
+    'ms-vscode.powershell',
+    'github.vscode-pull-request-github',
+    'davidanson.vscode-markdownlint',
+    'usernamehw.errorlens'
+)
+$extensions | Foreach-Object { code --install-extension $_ --force }
+
+Write-Information 'Done! Type "code" to open VSCode or "code ." to open the current directory in VSCode.'
+```

Getting-Started/01-Common-Errors - sp-MX.md

@@ -0,0 +1,102 @@
+# Common Errors
+
+La secuencia de comandos de instalación proporcionada en el archivo README.md de este proyecto está diseñado para protegerlo de errores comunes cuando instala cosas de la Galería de PowerShell por primera vez. A continuación se muestra una colección de estos errores, por lo que si se encuentra con ellos, sepa lo que significan y qué debe hacer.
+
+## No se encontró ninguna coincidencia para los criterios de búsqueda y el nombre del módulo especificados
+
+No se encontró ninguna coincidencia para los criterios de búsqueda y el nombre del módulo especificados
+
+```powershell
+PS C:\> Install-Module MilestonePSTools
+WARNING: Unable to resolve package source 'https://www.powershellgallery.com/api/v2'.
+PackageManagement\Install-Package : No match was found for the specified search criteria and module name
+'MilestonePSTools'. Try Get-PSRepository to see all available registered module repositories.
+At C:\Program Files\WindowsPowerShell\Modules\PowerShellGet\1.0.0.1\PSModule.psm1:1809 char:21
++ ...          $null = PackageManagement\Install-Package @PSBoundParameters
++                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+    + CategoryInfo          : ObjectNotFound: (Microsoft.Power....InstallPackage:InstallPackage) [Install-Package], Ex
+   ception
+    + FullyQualifiedErrorId : NoMatchFoundForCriteria,Microsoft.PowerShell.PackageManagement.Cmdlets.InstallPackage
+```
+
+El problema no es que el nombre del módulo se haya escrito incorrectamente o que no se pueda encontrar en PSGallery. El problema es que PowerShell no pudo *conectarse* a [https://www.powershellgallery.com](https://www.powershellgallery.com) porque PSGallery requiere una conexión HTTPS usando al menos TLS 1.2, y las versiones anteriores de PowerShellGet aún usan una versión anterior de TLS o SSL.
+
+
+### Solución
+
+Para resolver esto, necesitamos decirle a PowerShell qué protocolos queremos usar. Una forma de hacerlo es ejecutar la línea bastante esotérica del código de PowerShell a continuación. Utiliza la clase .NET System.Net.ServicePointManager y modifica SecurityProtocol para incluir TLS 1.2 además de los protocolos que ya estén permitidos.
+
+```powershell
+[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
+```
+
+Así es como se ve después de ejecutar esto en una instancia limpia de Windows 10 Sandbox:
+
+```powershell
+PS C:\> [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
+PS C:\> [Net.ServicePointManager]::SecurityProtocol
+Tls11, Tls12
+PS C:\>
+```
+
+## El comando se encontró en el módulo, pero el módulo no se pudo cargar
+
+Esto es muy común en Windows 10 porque la política de ejecución predeterminada de Microsoft en Windows 10 es "Restringida". Esto significa que PowerShell no puede ejecutar *ningún* archivo *.ps1 o *.psm1. Cuando utiliza `Import-Module` para importar MilestonePSTools, o cuando usa un comando dentro del módulo como `Connect-ManagementServer`, lo primero que hace PowerShell es ejecutar el archivo .PSM1 dentro de la carpeta de instalación del módulo. Con una política de ejecución de "Restringida", PowerShell no puede cargar el módulo..
+
+```powershell
+PS C:\> Connect-ManagementServer -ShowDialog
+Connect-ManagementServer : The 'Connect-ManagementServer' command was found in the module 'MilestonePSTools', but the
+module could not be loaded. For more information, run 'Import-Module MilestonePSTools'.
+At line:1 char:1
++ Connect-ManagementServer -ShowDialog
++ ~~~~~~~~~~~~~~~~~~~~~~~~
+    + CategoryInfo          : ObjectNotFound: (Connect-ManagementServer:String) [], CommandNotFoundException
+    + FullyQualifiedErrorId : CouldNotAutoloadMatchingModule
+```
+
+PowerShell suele ser bastante bueno para brindarle la información que necesita en el mensaje de error. En este caso, le recomienda ejecutar `Import-Module MilestonePSTools` para obtener más información sobre el problema. Así es como se ve eso ...
+
+```powershell
+PS C:\> Import-Module MilestonePSTools
+Import-Module : File C:\Program Files\WindowsPowerShell\Modules\MipSdkRedist\21.1.1\MipSdkRedist.psm1 cannot be loaded
+because running scripts is disabled on this system. For more information, see about_Execution_Policies at
+https:/go.microsoft.com/fwlink/?LinkID=135170.
+At line:1 char:1
++ import-module milestonepstools
++ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+    + CategoryInfo          : SecurityError: (:) [Import-Module], PSSecurityException
+    + FullyQualifiedErrorId : UnauthorizedAccess,Microsoft.PowerShell.Commands.ImportModuleCommand
+```
+
+Puede ver que el mensaje de error más detallado hace referencia a las políticas de ejecución de manera más específica
+
+### Solución
+
+La forma de solucionarlo es [cambiar su política de ejecución](https:/go.microsoft.com/fwlink/?LinkID=135170).. Recomiendo leer más sobre las políticas de ejecución de Microsoft, ya que no podemos cubrir todo el tema aquí. Nuestra preferencia por una política de ejecución es cambiarla a "RemoteSigned". Esto significa que podrá ejecutar cualquier secuencia de comandos local de PowerShell, pero se requerirá que otras secuencias de comandos, descargadas de un origen de Internet que no sea de confianza, estén firmadas por un certificado de firma de código en el que ya confíe. Puede hacer que una secuencia de comandos ”remota” que no sea de confianza sea “local” y “de confianza” al hacer clic derecho en el archivo y marcando la casilla de verificación “desbloquear” en la parte inferior de la pestaña General. Si no ve esa casilla de verificación, entonces el archivo no está “bloqueado” y Windows debería permitirle ejecutar el archivo siempre que su política de ejecución sea al menos “RemoteSigned”.
+
+Ejecute el comando `Set-ExecutionPolicy` como administrador para modificar la política en el nivel del equipo. También puede especificar un alcance de "CurrentUser" o "Process", por lo que, si tiene tiempo, le recomiendo leer la base de conocimiento de Microsoft sobre políticas de ejecución para obtener una comprensión completa de las opciones y sus implicaciones.
+
+```powershell
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
+```
+
+## Repositorio que no es de confianza
+
+Si bien en realidad no es un error, cuando ve este mensaje por primera vez puede ser confuso. Justificadamente, es posible que se pregunte si debe proceder a instalar algo de una fuente que no sea de confianza. El repositorio de PSGallery es la [Galería de PowerShell](https://www.powershellgallery.com) administrada por Microsoft. Es una colección de miles de paquetes que contienen módulos de PowerShell como [MilestonePSTools](https://www.powershellgallery.com/packages/MilestonePSTools). De forma predeterminada, el repositorio de PSGallery incluido con el módulo PowerShellGet integrado no es de confianza. Por lo tanto, se le preguntará cada vez que necesite instalar o actualizar un módulo de este repositorio.
+
+```powershell
+PS C:\> Install-Module MilestonePSTools
+
+Untrusted repository
+You are installing the modules from an untrusted repository. If you trust this repository, change its
+InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from
+'PSGallery'?
+```
+
+### SoluSolucióntion
+
+Puede optar por reconocer este mensaje cada vez o puede establecer la `Política de instalación` para el repositorio en "De confianza". A continuación, le indicamos cómo hacerlo:
+
+```powershell
+Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
+```