322 lines
461 KiB
HTML
322 lines
461 KiB
HTML
|
<!DOCTYPE html>
|
|||
|
<html><head><title>PowerShell 进阶</title><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta property="og:title" content="PowerShell 进阶"/><meta property="og:description" content="PowerShell 进阶."/><meta property="og:image" content="https://wiki.7wate.com/static/og-image.png"/><meta property="og:width" content="1200"/><meta property="og:height" content="675"/><link rel="icon" href="../../../../static/icon.png"/><meta name="description" content="PowerShell 进阶."/><meta name="generator" content="Quartz"/><link rel="preconnect" href="https://fonts.googleapis.com"/><link rel="preconnect" href="https://fonts.gstatic.com"/><script async src="https://umami.7wate.com/script.js" data-website-id="c061efdc-95dd-4d21-9d04-a1ffda0a85b9"></script><script>
|
|||
|
var _hmt = _hmt || [];
|
|||
|
(function() {
|
|||
|
var hm = document.createElement("script");
|
|||
|
hm.src = "https://hm.baidu.com/hm.js?94d8ccb156eb7c65abf317e6e01cdba9";
|
|||
|
var s = document.getElementsByTagName("script")[0];
|
|||
|
s.parentNode.insertBefore(hm, s);
|
|||
|
})();
|
|||
|
</script><script async src="https://www.googletagmanager.com/gtag/js?id=G-MHMEL0F832"></script><script>
|
|||
|
(function() {
|
|||
|
window.dataLayer = window.dataLayer || [];
|
|||
|
function gtag() {
|
|||
|
window.dataLayer.push(arguments);
|
|||
|
}
|
|||
|
gtag('js', new Date());
|
|||
|
gtag('config', 'G-MHMEL0F832');
|
|||
|
})();
|
|||
|
</script><link href="../../../../index.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" rel="stylesheet" type="text/css" spa-preserve/><link href="https://fonts.googleapis.com/css2?family=IBM Plex Mono&family=Schibsted Grotesk:wght@400;700&family=Source Sans Pro:ital,wght@0,400;0,600;1,400;1,600&display=swap" rel="stylesheet" type="text/css" spa-preserve/><script src="../../../../prescript.js" type="application/javascript" spa-preserve></script><script type="application/javascript" spa-preserve>const fetchData = fetch(`../../../../static/contentIndex.json`).then(data => data.json())</script></head><body data-slug="Tech/getting-started/命令行工具/PowerShell/PowerShell-进阶"><div id="quartz-root" class="page"><div id="quartz-body"><div class="left sidebar"><h1 class="page-title "><a href="../../../..">📚 X·Eden</a></h1><div class="spacer mobile-only"></div><div class="search "><div id="search-icon"><p>Search</p><div></div><svg tabIndex="0" aria-labelledby="title desc" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 19.9 19.7"><title id="title">Search</title><desc id="desc">Search</desc><g class="search-path" fill="none"><path stroke-linecap="square" d="M18.5 18.3l-5.4-5.4"></path><circle cx="8" cy="8" r="7"></circle></g></svg></div><div id="search-container"><div id="search-space"><input autocomplete="off" id="search-bar" name="search" type="text" aria-label="Search for something" placeholder="Search for something"/><div id="results-container"></div></div></div></div><div class="darkmode "><input class="toggle" id="darkmode-toggle" type="checkbox" tabIndex="-1"/><label id="toggle-label-light" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="dayIcon" x="0px" y="0px" viewBox="0 0 35 35" style="enable-background:new 0 0 35 35;" xmlSpace="preserve"><title>Light mode</title><path d="M6,17.5C6,16.672,5.328,16,4.5,16h-3C0.672,16,0,16.672,0,17.5 S0.672,19,1.5,19h3C5.328,19,6,18.328,6,17.5z M7.5,26c-0.414,0-0.789,0.168-1.061,0.439l-2,2C4.168,28.711,4,29.086,4,29.5 C4,30.328,4.671,31,5.5,31c0.414,0,0.789-0.168,1.06-0.44l2-2C8.832,28.289,9,27.914,9,27.5C9,26.672,8.329,26,7.5,26z M17.5,6 C18.329,6,19,5.328,19,4.5v-3C19,0.672,18.329,0,17.5,0S16,0.672,16,1.5v3C16,5.328,16.671,6,17.5,6z M27.5,9 c0.414,0,0.789-0.168,1.06-0.439l2-2C30.832,6.289,31,5.914,31,5.5C31,4.672,30.329,4,29.5,4c-0.414,0-0.789,0.168-1.061,0.44 l-2,2C26.168,6.711,26,7.086,26,7.5C26,8.328,26.671,9,27.5,9z M6.439,8.561C6.711,8.832,7.086,9,7.5,9C8.328,9,9,8.328,9,7.5 c0-0.414-0.168-0.789-0.439-1.061l-2-2C6.289,4.168,5.914,4,5.5,4C4.672,4,4,4.672,4,5.5c0,0.414,0.168,0.789,0.439,1.06 L6.439,8.561z M33.5,16h-3c-0.828,0-1.5,0.672-1.5,1.5s0.672,1.5,1.5,1.5h3c0.828,0,1.5-0.672,1.5-1.5S34.328,16,33.5,16z M28.561,26.439C28.289,26.168,27.914,26,27.5,26c-0.828,0-1.5,0.672-1.5,1.5c0,0.414,0.168,0.789,0.439,1.06l2,2 C28.711,30.832,29.086,31,29.5,31c0.828,0,1.5-0.672,1.5-1.5c0-0.414-0.168-0.789-0.439-1.061L28.561,26.439z M17.5,29 c-0.829,0-1.5,0.672-1.5,1.5v3c0,0.828,0.671,1.5,1.5,1.5s1.5-0.672,1.5-1.5v-3C19,29.672,18.329,29,17.5,29z M17.5,7 C11.71,7,7,11.71,7,17.5S11.71,28,17.5,28S28,23.29,28,17.5S23.29,7,17.5,7z M17.5,25c-4.136,0-7.5-3.364-7.5-7.5 c0-4.136,3.364-7.5,7.5-7.5c4.136,0,7.5,3.364,7.5,7.5C25,21.636,21.636,25,17.5,25z"></path></svg></label><label id="toggle-label-dark" for="darkmode-toggle" tabIndex="-1"><svg xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" version="1.1" id="nightIcon" x="0px" y="0px" viewBox="0 0 100 100" style="enable-background='new 0 0 100 100'" xmlSpace="preserve"><title>Dark mode</title><path d="M96.76,66.458c-0.853-0.852-2.15-1.064-3.23-0.534c-6.063,2.991-12.858,4.571-19.655,4.571 C62.022,70.495,50.88,65.88,42.5,57.5C29.043,44.043,25.658,23.536,34.076,6.47c0.532-1.08,0.318-2.379-0.534-3.23 c-0.851-0.852-2.15-1.064-3.23-0.534c-4.918,2.427-9.375,5.619-13.246,9.491c-9.447,9.447-14.65
|
|||
|
<h3 id="函数定义和调用">函数定义和调用<a aria-hidden="true" tabindex="-1" href="#函数定义和调用" class="internal"> §</a></h3>
|
|||
|
<p>在 PowerShell 中,函数是一段可以重复使用的代码块。定义函数使用 <code>function</code> 关键字:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Hello, World!"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 调用函数</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Get-Greeting</span></span></code></pre></div>
|
|||
|
<h3 id="函数参数">函数参数<a aria-hidden="true" tabindex="-1" href="#函数参数" class="internal"> §</a></h3>
|
|||
|
<p>函数可以接受参数,使其更通用和灵活。可以通过 <code>param</code> 关键字定义参数:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">string</span><span style="color:var(--shiki-color-text);">]$name </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"World"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Hello, $name!"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 调用函数并传递参数</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">name </span><span style="color:var(--shiki-token-string-expression);">"Alice"</span></span></code></pre></div>
|
|||
|
<h3 id="返回值">返回值<a aria-hidden="true" tabindex="-1" href="#返回值" class="internal"> §</a></h3>
|
|||
|
<p>函数可以返回值,这使得它们可以用于复杂的计算和逻辑操作:</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Add-Numbers</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">int</span><span style="color:var(--shiki-color-text);">]$a</span><span style="color:var(--shiki-token-keyword);">,</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">int</span><span style="color:var(--shiki-color-text);">]$b</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> $a </span><span style="color:var(--shiki-token-keyword);">+</span><span style="color:var(--shiki-color-text);"> $b</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 调用函数并获取返回值</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">$result </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Add-Numbers</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">a </span><span style="color:var(--shiki-token-constant);">5</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">b </span><span style="color:var(--shiki-token-constant);">3</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"The sum is: $result"</span></span></code></pre></div>
|
|||
|
<h3 id="高级函数功能">高级函数功能<a aria-hidden="true" tabindex="-1" href="#高级函数功能" class="internal"> §</a></h3>
|
|||
|
<ul>
|
|||
|
<li><strong>高级参数设置</strong>:通过 <code>Parameter</code> 特性定义参数属性,例如 <code>Mandatory</code> 和 <code>Position</code>。</li>
|
|||
|
<li><strong>支持管道输入</strong>:使用 <code>ValueFromPipeline</code> 参数特性允许函数接收管道输入。</li>
|
|||
|
</ul>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Square</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-function);">CmdletBinding</span><span style="color:var(--shiki-color-text);">()]</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-function);">Parameter</span><span style="color:var(--shiki-color-text);">(Mandatory</span><span style="color:var(--shiki-token-keyword);">,</span><span style="color:var(--shiki-color-text);"> ValueFromPipeline)]</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">int</span><span style="color:var(--shiki-color-text);">]$number</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">process</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">return</span><span style="color:var(--shiki-color-text);"> $number </span><span style="color:var(--shiki-token-keyword);">*</span><span style="color:var(--shiki-color-text);"> $number</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> }</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 使用管道输入</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-constant);">1</span><span style="color:var(--shiki-token-keyword);">..</span><span style="color:var(--shiki-token-constant);">5</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">|</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Square</span></span></code></pre></div>
|
|||
|
<h2 id="模块">模块<a aria-hidden="true" tabindex="-1" href="#模块" class="internal"> §</a></h2>
|
|||
|
<h3 id="模块是什么">模块是什么<a aria-hidden="true" tabindex="-1" href="#模块是什么" class="internal"> §</a></h3>
|
|||
|
<p>模块是 PowerShell 中的一种打包方式,允许将相关的函数、cmdlet、变量和其他资源组织在一起,以便重用和共享。模块可以帮助你管理和分发 PowerShell 代码。</p>
|
|||
|
<h3 id="创建和使用模块">创建和使用模块<a aria-hidden="true" tabindex="-1" href="#创建和使用模块" class="internal"> §</a></h3>
|
|||
|
<p>创建一个模块只需将相关的函数和代码放在一个 <code>.psm1</code> 文件中。以下是一个简单模块的示例:</p>
|
|||
|
<ol>
|
|||
|
<li>创建一个名为 <code>MyModule.psm1</code> 的文件,并添加以下内容:</li>
|
|||
|
</ol>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">string</span><span style="color:var(--shiki-color-text);">]$name </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"World"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Hello, $name!"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span></code></pre></div>
|
|||
|
<ol>
|
|||
|
<li>将模块文件放在一个文件夹中,并将文件夹命名为模块的名称,例如 <code>MyModule</code>。</li>
|
|||
|
<li>使用模块:</li>
|
|||
|
</ol>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 确保模块文件夹路径包含在 $env:PSModulePath 中</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Import-Module</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Name </span><span style="color:var(--shiki-token-string-expression);">"MyModule"</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 使用模块中的函数</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">name </span><span style="color:var(--shiki-token-string-expression);">"Alice"</span></span></code></pre></div>
|
|||
|
<h3 id="import-module-和-export-module">Import-Module 和 Export-Module<a aria-hidden="true" tabindex="-1" href="#import-module-和-export-module" class="internal"> §</a></h3>
|
|||
|
<ul>
|
|||
|
<li><strong>Import-Module</strong>:用于加载模块,使其中定义的命令和功能可用。</li>
|
|||
|
</ul>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-function);">Import-Module</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Name </span><span style="color:var(--shiki-token-string-expression);">"MyModule"</span></span></code></pre></div>
|
|||
|
<ul>
|
|||
|
<li><strong>Export-ModuleMember</strong>:用于指定哪些函数、变量或别名可以导出并供模块使用者使用。添加到 <code>.psm1</code> 文件中:</li>
|
|||
|
</ul>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">string</span><span style="color:var(--shiki-color-text);">]$name </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"World"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Hello, $name!"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Export-ModuleMember</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Function </span><span style="color:var(--shiki-token-function);">Get-Greeting</span></span></code></pre></div>
|
|||
|
<h3 id="示例创建和使用模块">示例:创建和使用模块<a aria-hidden="true" tabindex="-1" href="#示例创建和使用模块" class="internal"> §</a></h3>
|
|||
|
<p>以下是一个完整示例,展示如何创建和使用模块:</p>
|
|||
|
<ol>
|
|||
|
<li>创建模块文件夹 <code>MyModule</code>。</li>
|
|||
|
<li>在模块文件夹中创建 <code>MyModule.psm1</code> 文件,内容如下:</li>
|
|||
|
</ol>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">string</span><span style="color:var(--shiki-color-text);">]$name </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"World"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Hello, $name!"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Export-ModuleMember</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Function </span><span style="color:var(--shiki-token-function);">Get-Greeting</span></span></code></pre></div>
|
|||
|
<ol>
|
|||
|
<li>在 PowerShell 中导入并使用模块:</li>
|
|||
|
</ol>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 设置模块路径(如果需要)</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">$</span><span style="color:var(--shiki-token-constant);">env:</span><span style="color:var(--shiki-color-text);">PSModulePath </span><span style="color:var(--shiki-token-keyword);">+=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">";C:\Path\To\Your\Module\Directory"</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 导入模块</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Import-Module</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Name </span><span style="color:var(--shiki-token-string-expression);">"MyModule"</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 使用模块中的函数</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Get-Greeting</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">name </span><span style="color:var(--shiki-token-string-expression);">"Alice"</span></span></code></pre></div>
|
|||
|
<h3 id="模块发布">模块发布<a aria-hidden="true" tabindex="-1" href="#模块发布" class="internal"> §</a></h3>
|
|||
|
<p>可以将模块发布到 PowerShell Gallery 或私有仓库,方便其他用户安装和使用。</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 将模块发布到 PowerShell Gallery</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Publish-Module</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Name </span><span style="color:var(--shiki-token-string-expression);">"MyModule"</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">NuGetApiKey </span><span style="color:var(--shiki-token-string-expression);">"YourApiKey"</span></span></code></pre></div>
|
|||
|
<h2 id="错误处理">错误处理<a aria-hidden="true" tabindex="-1" href="#错误处理" class="internal"> §</a></h2>
|
|||
|
<h3 id="错误处理基础trycatchfinally">错误处理基础(try/catch/finally)<a aria-hidden="true" tabindex="-1" href="#错误处理基础trycatchfinally" class="internal"> §</a></h3>
|
|||
|
<p>在 PowerShell 中,可以使用 <code>try</code>, <code>catch</code> 和 <code>finally</code> 语句来处理脚本中的错误。</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">try</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-comment);"># 尝试执行的代码</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> $result </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Process</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Name </span><span style="color:var(--shiki-token-string-expression);">"Notepad"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Process found: </span><span style="color:var(--shiki-token-keyword);">$</span><span style="color:var(--shiki-token-string-expression);">($result.Name)</span><span style="color:var(--shiki-token-string-expression);">"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">} </span><span style="color:var(--shiki-token-keyword);">catch</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-comment);"># 捕获错误并处理</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"An error occurred: </span><span style="color:var(--shiki-token-constant);">$_</span><span style="color:var(--shiki-token-string-expression);">"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">} </span><span style="color:var(--shiki-token-keyword);">finally</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-comment);"># 无论是否发生错误都会执行的代码</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Completed the error handling section."</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span></code></pre></div>
|
|||
|
<h3 id="捕获和处理异常">捕获和处理异常<a aria-hidden="true" tabindex="-1" href="#捕获和处理异常" class="internal"> §</a></h3>
|
|||
|
<p><code>catch</code> 块可以捕获不同类型的异常,并根据异常类型采取相应的处理措施。</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">try</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-comment);"># 尝试执行的代码</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> $result </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Process</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Name </span><span style="color:var(--shiki-token-string-expression);">"Notepad"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Process found: </span><span style="color:var(--shiki-token-keyword);">$</span><span style="color:var(--shiki-token-string-expression);">($result.Name)</span><span style="color:var(--shiki-token-string-expression);">"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">} </span><span style="color:var(--shiki-token-keyword);">catch</span><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">System.Management.Automation.CommandNotFoundException</span><span style="color:var(--shiki-color-text);">] {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Command not found: </span><span style="color:var(--shiki-token-constant);">$_</span><span style="color:var(--shiki-token-string-expression);">"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">} </span><span style="color:var(--shiki-token-keyword);">catch</span><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">System.Exception</span><span style="color:var(--shiki-color-text);">] {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"General error: </span><span style="color:var(--shiki-token-constant);">$_</span><span style="color:var(--shiki-token-string-expression);">"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span></code></pre></div>
|
|||
|
<h3 id="自定义错误处理">自定义错误处理<a aria-hidden="true" tabindex="-1" href="#自定义错误处理" class="internal"> §</a></h3>
|
|||
|
<p>可以自定义错误处理逻辑,使脚本更具健壮性和用户友好性。</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-ProcessInfo</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">string</span><span style="color:var(--shiki-color-text);">]$processName</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">try</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> $process </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Get-Process</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Name $processName </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">ErrorAction Stop</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Process Name: </span><span style="color:var(--shiki-token-keyword);">$</span><span style="color:var(--shiki-token-string-expression);">($process.Name)</span><span style="color:var(--shiki-token-string-expression);">"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"CPU Usage: </span><span style="color:var(--shiki-token-keyword);">$</span><span style="color:var(--shiki-token-string-expression);">($process.CPU)</span><span style="color:var(--shiki-token-string-expression);">"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> } </span><span style="color:var(--shiki-token-keyword);">catch</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Error: Process '$processName' not found."</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> }</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Get-ProcessInfo</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">processName </span><span style="color:var(--shiki-token-string-expression);">"Notepad"</span></span></code></pre></div>
|
|||
|
<h2 id="调试">调试<a aria-hidden="true" tabindex="-1" href="#调试" class="internal"> §</a></h2>
|
|||
|
<h3 id="使用断点调试脚本">使用断点调试脚本<a aria-hidden="true" tabindex="-1" href="#使用断点调试脚本" class="internal"> §</a></h3>
|
|||
|
<p>可以在脚本中设置断点,以便逐步执行和调试代码。</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 设置断点</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Set-PSBreakpoint</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Script </span><span style="color:var(--shiki-token-string-expression);">"C:\Path\To\YourScript.ps1"</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Line </span><span style="color:var(--shiki-token-constant);">5</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 启动调试</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Get-Process</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 移除断点</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Remove-PSBreakpoint</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Id </span><span style="color:var(--shiki-token-constant);">0</span></span></code></pre></div>
|
|||
|
<h3 id="调试命令和技巧">调试命令和技巧<a aria-hidden="true" tabindex="-1" href="#调试命令和技巧" class="internal"> §</a></h3>
|
|||
|
<p>PowerShell 提供了一些用于调试脚本的命令和技巧:</p>
|
|||
|
<ul>
|
|||
|
<li><code>Get-PSBreakpoint</code>:查看当前设置的断点。</li>
|
|||
|
<li><code>Enable-PSBreakpoint</code> 和 <code>Disable-PSBreakpoint</code>:启用或禁用断点。</li>
|
|||
|
<li><code>Step-Into</code>、<code>Step-Over</code> 和 <code>Step-Out</code>:逐步执行代码。</li>
|
|||
|
<li><code>Get-PSCallStack</code>:查看当前调用堆栈。</li>
|
|||
|
</ul>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 调试示例</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Test-Debug</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> ($a</span><span style="color:var(--shiki-token-keyword);">,</span><span style="color:var(--shiki-color-text);"> $b)</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> $sum </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> $a </span><span style="color:var(--shiki-token-keyword);">+</span><span style="color:var(--shiki-color-text);"> $b</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Sum: $sum"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 设置断点在函数的第一行</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Set-PSBreakpoint</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Script </span><span style="color:var(--shiki-token-string-expression);">"C:\Path\To\YourScript.ps1"</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Command </span><span style="color:var(--shiki-token-string-expression);">"Test-Debug"</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 调用函数,触发断点</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Test-Debug</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">a </span><span style="color:var(--shiki-token-constant);">5</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">b </span><span style="color:var(--shiki-token-constant);">10</span></span></code></pre></div>
|
|||
|
<h3 id="调试日志">调试日志<a aria-hidden="true" tabindex="-1" href="#调试日志" class="internal"> §</a></h3>
|
|||
|
<p>使用 <code>Write-Debug</code> 和 <code>Write-Verbose</code> 命令输出调试信息和详细信息。</p>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-keyword);">function</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Test-Logging</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-function);">CmdletBinding</span><span style="color:var(--shiki-color-text);">()]</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">param</span><span style="color:var(--shiki-color-text);"> (</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> [</span><span style="color:var(--shiki-token-keyword);">string</span><span style="color:var(--shiki-color-text);">]$message</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> )</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Debug</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Debug: $message"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Verbose</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-string-expression);">"Verbose: $message"</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span>
|
|||
|
<span data-line> </span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-comment);"># 调用函数并启用调试和详细输出</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Test-Logging</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">message </span><span style="color:var(--shiki-token-string-expression);">"Test message"</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Debug </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Verbose</span></span></code></pre></div>
|
|||
|
<h2 id="性能优化">性能优化<a aria-hidden="true" tabindex="-1" href="#性能优化" class="internal"> §</a></h2>
|
|||
|
<h3 id="提升脚本性能的方法">提升脚本性能的方法<a aria-hidden="true" tabindex="-1" href="#提升脚本性能的方法" class="internal"> §</a></h3>
|
|||
|
<p>优化脚本性能可以显著提高执行效率。以下是一些提升性能的方法:</p>
|
|||
|
<ul>
|
|||
|
<li>避免不必要的循环和递归。</li>
|
|||
|
<li>使用高效的 cmdlet 和操作,例如 <code>Measure-Command</code> 来衡量代码块的执行时间。</li>
|
|||
|
<li>尽量减少对外部资源的访问,例如磁盘 I/O 操作。</li>
|
|||
|
<li>使用变量缓存重复计算的值。</li>
|
|||
|
</ul>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 示例:使用 Measure-Command 测量执行时间</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Measure-Command</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> $sum </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">0</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">for</span><span style="color:var(--shiki-color-text);"> ($i </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">0</span><span style="color:var(--shiki-color-text);">; $i </span><span style="color:var(--shiki-token-keyword);">-lt</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">1000000</span><span style="color:var(--shiki-color-text);">; $i</span><span style="color:var(--shiki-token-keyword);">++</span><span style="color:var(--shiki-color-text);">) {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> $sum </span><span style="color:var(--shiki-token-keyword);">+=</span><span style="color:var(--shiki-color-text);"> $i</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> }</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span></code></pre></div>
|
|||
|
<h3 id="性能监控工具">性能监控工具<a aria-hidden="true" tabindex="-1" href="#性能监控工具" class="internal"> §</a></h3>
|
|||
|
<p>PowerShell 提供了一些工具来监控和分析脚本性能:</p>
|
|||
|
<ul>
|
|||
|
<li><code>Measure-Command</code>:测量代码块的执行时间。</li>
|
|||
|
<li><code>Measure-Object</code>:测量对象的属性,例如长度、平均值、最大值、最小值。</li>
|
|||
|
<li><code>Get-EventLog</code> 和 <code>Get-WinEvent</code>:检查系统事件日志,分析脚本对系统资源的影响。</li>
|
|||
|
</ul>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 使用 Measure-Object 统计数据</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">$data </span><span style="color:var(--shiki-token-keyword);">=</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">1</span><span style="color:var(--shiki-token-keyword);">..</span><span style="color:var(--shiki-token-constant);">100</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">$data </span><span style="color:var(--shiki-token-keyword);">|</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Measure-Object</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Sum </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Average </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Maximum </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Minimum</span></span></code></pre></div>
|
|||
|
<h3 id="内存管理">内存管理<a aria-hidden="true" tabindex="-1" href="#内存管理" class="internal"> §</a></h3>
|
|||
|
<p>在处理大量数据时,优化内存使用也是提升性能的关键。可以通过以下方法进行内存管理:</p>
|
|||
|
<ul>
|
|||
|
<li>使用 <code>[System.Collections.Generic.List[<Type>]]</code> 代替数组,以减少内存分配和复制。</li>
|
|||
|
<li>在处理大型文本文件时,使用流式读取(<code>Get-Content -ReadCount</code>)来减少内存占用。</li>
|
|||
|
</ul>
|
|||
|
<div data-rehype-pretty-code-fragment><pre style="background-color:var(--shiki-color-background);" tabindex="0" data-language="powershell" data-theme="default"><code data-language="powershell" data-theme="default"><span data-line><span style="color:var(--shiki-token-comment);"># 示例:使用流式读取处理大型文本文件</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-token-function);">Get-Content</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">Path </span><span style="color:var(--shiki-token-string-expression);">"largefile.txt"</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">-</span><span style="color:var(--shiki-color-text);">ReadCount </span><span style="color:var(--shiki-token-constant);">1000</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">|</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">ForEach-Object</span><span style="color:var(--shiki-color-text);"> {</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-comment);"># 处理每批次的行</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">$_</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-keyword);">|</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">ForEach-Object</span><span style="color:var(--shiki-color-text);"> { </span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-comment);"># 处理单行</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-function);">Write-Output</span><span style="color:var(--shiki-color-text);"> </span><span style="color:var(--shiki-token-constant);">$_</span><span style="color:var(--shiki-color-text);"> </span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);"> }</span></span>
|
|||
|
<span data-line><span style="color:var(--shiki-color-text);">}</span></span></code></pre></div></article></div><div class="right sidebar"><div class="graph "><h3>Graph View</h3><div class="graph-outer"><div id="graph-container" data-cfg="{"drag":true,"zoom":true,"depth":1,"scale":1.1,"repelForce":0.5,"centerForce":0.3,"linkDistance":30,"fontSize":0.6,"opacityScale":1,"showTags":true,"removeTags":[]}"></div><svg version="1.1" id="global-graph-icon" xmlns="http://www.w3.org/2000/svg" xmlnsXlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 55 55" fill="currentColor" xmlSpace="preserve"><path d="M49,0c-3.309,0-6,2.691-6,6c0,1.035,0.263,2.009,0.726,2.86l-9.829,9.829C32.542,17.634,30.846,17,29,17
|
|||
|
s-3.542,0.634-4.898,1.688l-7.669-7.669C16.785,10.424,17,9.74,17,9c0-2.206-1.794-4-4-4S9,6.794,9,9s1.794,4,4,4
|
|||
|
c0.74,0,1.424-0.215,2.019-0.567l7.669,7.669C21.634,21.458,21,23.154,21,25s0.634,3.542,1.688,4.897L10.024,42.562
|
|||
|
C8.958,41.595,7.549,41,6,41c-3.309,0-6,2.691-6,6s2.691,6,6,6s6-2.691,6-6c0-1.035-0.263-2.009-0.726-2.86l12.829-12.829
|
|||
|
c1.106,0.86,2.44,1.436,3.898,1.619v10.16c-2.833,0.478-5,2.942-5,5.91c0,3.309,2.691,6,6,6s6-2.691,6-6c0-2.967-2.167-5.431-5-5.91
|
|||
|
v-10.16c1.458-0.183,2.792-0.759,3.898-1.619l7.669,7.669C41.215,39.576,41,40.26,41,41c0,2.206,1.794,4,4,4s4-1.794,4-4
|
|||
|
s-1.794-4-4-4c-0.74,0-1.424,0.215-2.019,0.567l-7.669-7.669C36.366,28.542,37,26.846,37,25s-0.634-3.542-1.688-4.897l9.665-9.665
|
|||
|
C46.042,11.405,47.451,12,49,12c3.309,0,6-2.691,6-6S52.309,0,49,0z M11,9c0-1.103,0.897-2,2-2s2,0.897,2,2s-0.897,2-2,2
|
|||
|
S11,10.103,11,9z M6,51c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S8.206,51,6,51z M33,49c0,2.206-1.794,4-4,4s-4-1.794-4-4
|
|||
|
s1.794-4,4-4S33,46.794,33,49z M29,31c-3.309,0-6-2.691-6-6s2.691-6,6-6s6,2.691,6,6S32.309,31,29,31z M47,41c0,1.103-0.897,2-2,2
|
|||
|
s-2-0.897-2-2s0.897-2,2-2S47,39.897,47,41z M49,10c-2.206,0-4-1.794-4-4s1.794-4,4-4s4,1.794,4,4S51.206,10,49,10z"></path></svg></div><div id="global-graph-outer"><div id="global-graph-container" data-cfg="{"drag":true,"zoom":true,"depth":-1,"scale":0.9,"repelForce":0.5,"centerForce":0.3,"linkDistance":30,"fontSize":0.6,"opacityScale":1,"showTags":true,"removeTags":[]}"></div></div></div><div class="toc desktop-only"><button type="button" id="toc" class><h3>Table of Contents</h3><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="fold"><polyline points="6 9 12 15 18 9"></polyline></svg></button><div id="toc-content"><ul class="overflow"><li class="depth-0"><a href="#函数" data-for="函数">函数</a></li><li class="depth-1"><a href="#函数定义和调用" data-for="函数定义和调用">函数定义和调用</a></li><li class="depth-1"><a href="#函数参数" data-for="函数参数">函数参数</a></li><li class="depth-1"><a href="#返回值" data-for="返回值">返回值</a></li><li class="depth-1"><a href="#高级函数功能" data-for="高级函数功能">高级函数功能</a></li><li class="depth-0"><a href="#模块" data-for="模块">模块</a></li><li class="depth-1"><a href="#模块是什么" data-for="模块是什么">模块是什么</a></li><li class="depth-1"><a href="#创建和使用模块" data-for="创建和使用模块">创建和使用模块</a></li><li class="depth-1"><a href="#import-module-和-export-module" data-for="import-module-和-export-module">Import-Module 和 Export-Module</a></li><li class="depth-1"><a href="#示例创建和使用模块" data-for="示例创建和使用模块">示例:创建和使用模块</a></li><li class="depth-1"><a href="#模块发布" data-for="模块发布">模块发布</a></li><li class="depth-0"><a href="#错误处理" data-for="错误处理">错误处理</a></li><li class="depth-1"><a href="#错误处理基础trycatchfinally" data-for="错误处理基础trycatchfinally">错误处理基础(try/catch/finally)</a></li><li class="depth-1"><a href="#捕获和处理异常" data-for="捕获和处理异常">捕获和处理异常</a></li><li class="depth-1"><a href="#自定义错误处理" data-for="自定义错误处理">自定义错误处理</a></li><li class="depth-0"><a href="#调试" data-for="调试">调试</a></li><li class="depth-1"><a href="#使用断点调试脚本" data-for="使用断点调试脚本">使用断点调试脚本</a></li><li class="depth-1"><a href="#调试命令和技巧" data-for="调试命令和技巧">调试命令和技巧</a></li><li class="depth-1"><a href="#调试日志" data-for="调试日志">调试日志</a></li><li class="depth-0"><a href="#性能优化" data-for="性能优化">性能优化</a></li><li class="depth-1"><a href="#提升脚本性能的方法" data-for="提升脚本性能的方法">提升脚本性能的方法</a></li><li class="depth-1"><a href="#性能监控工具" data-for="性能监控工具">性能监控工具</a></li><li class="depth-1"><a href="#内存管理" data-for="内存管理">内存管理</a></li></ul></div></div><div class="backlinks "><h3>Backlinks</h3><ul class="overflow"><li>No backlinks found</li></ul></div><div class="explorer mobile-only"><button type="button" id="explorer" data-behavior="collapse" data-collapsed="collapsed" data-savestate="true" data-tree="[{"path":"Basics","collapsed":true},{"path":"Basics/english","collapsed":true},{"path":"Blog","collapsed":true},{"path":"Book","collapsed":true},{"path":"Book/个人成长","collapsed":true},{"path":"Book/医学健康","collapsed":true},{"path":"Book/历史","collapsed":true},{"path":"
|
|||
|
function toggleCallout() {
|
|||
|
const outerBlock = this.parentElement;
|
|||
|
outerBlock.classList.toggle(`is-collapsed`);
|
|||
|
const collapsed = outerBlock.classList.contains(`is-collapsed`);
|
|||
|
const height = collapsed ? this.scrollHeight : outerBlock.scrollHeight;
|
|||
|
outerBlock.style.maxHeight = height + `px`;
|
|||
|
let current = outerBlock;
|
|||
|
let parent = outerBlock.parentElement;
|
|||
|
while (parent) {
|
|||
|
if (!parent.classList.contains(`callout`)) {
|
|||
|
return;
|
|||
|
}
|
|||
|
const collapsed2 = parent.classList.contains(`is-collapsed`);
|
|||
|
const height2 = collapsed2 ? parent.scrollHeight : parent.scrollHeight + current.scrollHeight;
|
|||
|
parent.style.maxHeight = height2 + `px`;
|
|||
|
current = parent;
|
|||
|
parent = parent.parentElement;
|
|||
|
}
|
|||
|
}
|
|||
|
function setupCallout() {
|
|||
|
const collapsible = document.getElementsByClassName(
|
|||
|
`callout is-collapsible`
|
|||
|
);
|
|||
|
for (const div of collapsible) {
|
|||
|
const title = div.firstElementChild;
|
|||
|
if (title) {
|
|||
|
title.removeEventListener(`click`, toggleCallout);
|
|||
|
title.addEventListener(`click`, toggleCallout);
|
|||
|
const collapsed = div.classList.contains(`is-collapsed`);
|
|||
|
const height = collapsed ? title.scrollHeight : div.scrollHeight;
|
|||
|
div.style.maxHeight = height + `px`;
|
|||
|
}
|
|||
|
}
|
|||
|
}
|
|||
|
document.addEventListener(`nav`, setupCallout);
|
|||
|
window.addEventListener(`resize`, setupCallout);
|
|||
|
</script><script type="module">
|
|||
|
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.esm.min.mjs';
|
|||
|
const darkMode = document.documentElement.getAttribute('saved-theme') === 'dark'
|
|||
|
mermaid.initialize({
|
|||
|
startOnLoad: false,
|
|||
|
securityLevel: 'loose',
|
|||
|
theme: darkMode ? 'dark' : 'default'
|
|||
|
});
|
|||
|
document.addEventListener('nav', async () => {
|
|||
|
await mermaid.run({
|
|||
|
querySelector: '.mermaid'
|
|||
|
})
|
|||
|
});
|
|||
|
</script><script src="https://cdn.jsdelivr.net/npm/katex@0.16.7/dist/contrib/copy-tex.min.js" type="application/javascript"></script><script src="../../../../postscript.js" type="module"></script></html>
|