主題
    about_Types.ps1xml

簡短描述
    說明 Types.ps1xml 檔案如何讓您擴充 Windows PowerShell 中使用的物件的 Microsoft .NET 
    Framework 型別。

完整描述
    Windows PowerShell 安裝目錄 ($pshome) 中的 Types.ps1xml 檔案是一種 XML 文字檔案,
    可讓您將屬性與方法新增至 Windows PowerShell 中使用的物件。Windows PowerShell 的內
    建 Types.ps1xml 檔案會將數個元素新增至 .NET Framework 型別,但您可以建立其他 
    Types.ps1xml 檔案,以進一步擴充型別。

    例如,陣列物件 (System.Array) 預設的 Length 屬性會列出陣列中的物件數目,但因為 
    "length" 這個名稱並未清楚描述屬性,Windows PowerShell 新增一個名稱為 "Count" 的屬
    性,顯示相同的值。下列 XML 會將 Count 屬性新增至 System.Array 型別。

        <Type>
            <Name>System.Array</Name>
            <Members>
                <AliasProperty>
                    <Name>Count</Name>
                    <ReferencedMemberName>
                        Length
                    </ReferencedMemberName>
                </AliasProperty>
            </Members>
        </Type>

    若要取得新的 AliasProperty,請在任何陣列上使用 Get-Member 命令,如下列範例所示。

        Get-Member -inputobject (1,2,3,4)


    這個命令會傳回下列結果。

	名稱           MemberType    定義
	----           ----------    ----------
	Count          AliasProperty Count = Length
	Address        Method        System.Object& Address(Int32 )
	Clone          Method        System.Object Clone()
	CopyTo         Method        System.Void CopyTo(Array array, Int32 index):
	Equals         Method        System.Boolean Equals(Object obj)
	Get            Method        System.Object Get(Int32 )
	...

    因此,您可以在 Windows PowerShell 中使用陣列的 Count 屬性或 Length 屬性。例如:

	C:\PS> (1, 2, 3, 4).count
	4

	C:\PS> (1, 2, 3, 4).length
	4
 

  建立新的 Types.ps1xml 檔案

      隨 Windows PowerShell 安裝的 .ps1xml 檔案都有加上數位簽章,以防竄改,因為格式可
      能包含指令區塊。因此,若要將屬性或方法新增至 .NET Framework 型別,請自行建立 
      Types.ps1xml 檔案,然後將其新增至 Windows PowerShell 主控台。

      若要建立新的檔案,請先複製現有的 Types.ps1xml 檔案。新的檔案可以任意命名,但副
      檔名必須為 .ps1xml。您可以將新的檔案放在 Windows PowerShell 可存取的任何目錄
      中,但是將檔案放在 Windows PowerShell 安裝目錄 ($pshome) 或安裝目錄的子目錄中很
      有用。

      在儲存新的檔案後,使用 Update-TypeData Cmdlet 將新的檔案新增至 Windows 
      PowerShell 主控台。如果想要讓您的型別的優先順序高於內建檔案中定義的型別,請使
      用 Update-TypeData Cmdlet 的 PrependData 參數。Update-TypeData 只會影響目
      前的主控台。若要讓所做的變更影響所有以後的主控台,請匯出目前的主控台,或將 
      Update-TypeData 命令新增至 Windows PowerShell 設定檔。


  Types.ps1xml 和 Add-Member

      Types.ps1xml 檔案會將屬性與方法新增至受影響的 Windows PowerShell 主控台內指定
      的 .NET Framework 型別的所有物件執行個體。不過,如果只要將屬性或方法新增至一
      個物件執行個體,請使用 Add-Member Cmdlet。

      如需詳細資訊,請參閱 Add-Member。


  範例:將 Age 成員新增至 FileInfo 物件

      在這個範例中,會示範如何將 Age 屬性新增至檔案物件 (System.IO.FileInfo)。檔案的存
      留時間是建立時間與目前時間的時間差,以天為單位。

      使用原始 Types.ps1xml 檔案做為新檔案的範本是最簡單的做法。下列命令會將原始檔案
      複製到 $pshome 目錄中一個叫做 MyTypes.ps1xml 的檔案。

          copy-item Types.ps1xml MyTypes.ps1xml


      接著,在任何像 [記事本] 這樣的 XML 或文字編輯器中開啟 Types.ps1xml 檔案。因為 
      Age 屬性是以指令碼區塊而計算得出的,請找出 <ScriptProperty> 標記以做為新的 Age 
      屬性的模型。

      複製程式碼的 <Type> 與 </Type> 標記之間的 XML,以建立指令碼屬性。然後刪除檔
      案中除了開頭 <?xml> 和 <Types> 標記與結尾 </Types> 標記外的剩餘部分。數位簽章
      也必須一併刪除,以免發生錯誤。

      從模型指令碼屬性 (例如下列自原始 Types.ps1xml 檔案複製的指令碼屬性) 開始。

          <?xml version="1.0" encoding="utf-8" ?>
          <Types>
              <Type>
                 <Name>System.Guid</Name>
                    <Members>
                        <ScriptProperty>
                            <Name>Guid</Name>
                            <GetScriptBlock>$this.ToString()</GetScriptBlock>
                        </ScriptProperty>
                    </Members>
              </Type>
          </Types>


      然後變更 .NET Framework 型別的名稱、屬性的名稱和指令碼區塊的值,以建立檔案物件
      的 Age 屬性。


          <?xml version="1.0" encoding="utf-8" ?>
          <Types>
              <Type>
                 <Name>System.IO.FileInfo</Name>
                    <Members>
                        <ScriptProperty>
                            <Name>Age</Name>
                            <GetScriptBlock>
                               ((get-date) - ($this.creationtime)).days
                            </GetScriptBlock>
                        </ScriptProperty>
                    </Members>
              </Type>
          </Types>


      在儲存檔案並加以關閉後,使用 Update-TypeData 命令 (例如下列命令) 將新的 
      Types.ps1xml 檔案新增至目前的工作階段。這個命令會使用 PrependData 參數,讓新檔
      案的優先順序高於原始檔案  (如需 Update-TypeData 的詳細資訊,請參閱 
      Update-TypeData)。

          update-typedata -prependpath $pshome\MyTypes.ps1xml

      若要測試所做的變更,請使用 Get-ChildItem 命令取得 $pshome 目錄中的 
      PowerShell.exe 檔案,然後經由管道將它輸出至 Format-List Cmdlet,以列出該檔案的
      所有屬性。由於上述變更,Age 屬性出現在清單中。

        get-childitem $pshome\powershell.exe | format-list -property *	


       PSPath            : Microsoft.PowerShell.Core\FileSystem::C:\WINDOWS...
        PSParentPath      : Microsoft.PowerShell.Core\FileSystem::C:\WINDOWS...
        PSChildName       : powershell.exe
        PSDrive           : C
        PSProvider        : Microsoft.PowerShell.Core\FileSystem
        PSIsContainer     : False
        Age               : 16
        VersionInfo       : File:             C:\WINDOWS\system32\WindowsPow...
                    InternalName:     POWERSHELL
                    OriginalFilename: PowerShell.EXE
	...



      您也可以使用下列命令來顯示檔案的 Age 屬性。

	  (get-childitem $pshome\powershell.exe).age
          16
 

  Types.ps1xml 檔案中的 XML

      <Types> 標記括住這個檔案中定義的所有型別。
      只應有一對 <Types> 標記。

      這個檔案所稱的每個 .NET Framework 型別都應由一對 <Type> 標記表示。

      Type 標記必須包含下列標記:

          <Name>:一對括住受影響的 .NET Framework 型別 
                  之名稱的 <Name> 標記。

          <Members>:一對括住為 .NET Framework 型別定義 
                     的新屬性與方法之標記的 <Members> 標記。

      任何下列成員標記都可以在 <Members> 標記之內。

      <AliasProperty>:定義現有屬性的新名稱。

         <AliasProperty> 標記必須有一組 <Name> 標記 (用於指定新屬性的名稱) 與一
         組 <ReferencedMemberName> 標記 (用於指定現有的屬性)。
         例如,Count 別名屬性是陣列物件的 Length 屬性的別名。

             <Type>
                 <Name>System.Array</Name>
                 <Members>
                     <AliasProperty>
                         <Name>Count</Name>
                         <ReferencedMemberName>Length</ReferencedMemberName>
                     </AliasProperty>
                 </Members>
             </Type>


      <CodeMethod>:參考 .NET Framework 類別的靜態方法。

         <CodeMethod> 標記必須有一組 <Name> 標記 (用於指定新方法的名稱) 與一組 
         <GetCodeReference> 標記 (用於指定其中會定義方法的程式碼)。
         例如,目錄 (System.IO.DirectoryInfo 物件) 的 Mode 屬性是 Windows PowerShell 
         FileSystem 提供者中定義的程式碼屬性。
        
             <Type>
                 <Name>System.IO.DirectoryInfo</Name>
                 <Members>
                     <CodeProperty>
                        <Name>Mode</Name>
                        <GetCodeReference>
                           <TypeName>Microsoft.PowerShell
                 .Commands.FileSystemProvider</TypeName>
                           <MethodName>Mode</MethodName>
                        </GetCodeReference>
                     </CodeProperty>
                 </Members>
             </Type>

 
      <CodeProperty>:參考 .NET Framework 類別的靜態方法。

         <CodeProperty> 標記必須有一組 <Name> 標記 (用於指定新屬性的名稱) 與一
         組 <GetCodeReference> 標記 (用於指定其中會定義屬性的程式碼)。
         例如,目錄 (System.IO.DirectoryInfo 物件) 的 Mode 屬性是 Windows PowerShell 
         FileSystem 提供者中定義的程式碼屬性。
             <Type>
                 <Name>System.IO.DirectoryInfo</Name>
                 <Members>
                     <CodeProperty>
                        <Name>Mode</Name>
                        <GetCodeReference>
                           <TypeName>Microsoft.PowerShell.
                   Commands.FileSystemProvider</TypeName>
                           <MethodName>Mode</MethodName>
                        </GetCodeReference>
                     </CodeProperty>
                 </Members>
             </Type>


      <MemberSet>:定義成員 (屬性與方法) 的集合。

         <MemberSet> 標記出現在主要 <Members> 標記之內。這個標記必須括住一對括住成
         員集名稱的 <Name> 標記,以及一對括住集合成員 (屬性與方法) 的次要 <Members> 
         標記。任何建立屬性的標記 (如 <NoteProperty> 或 <ScriptProperty>) 或建立方法的標
         記 (如 <Method> 或 <ScriptMethod>) 都可以是集合的成員。

         Types.ps1xml 檔案中的 <MemberSet> 標記是用來 
         定義 .NET Framework 物件在 Windows PowerShell 中的預設檢視。在此情況下,成員
         集合的名稱 (<Name> 標記中的值) 一定是 "PsStandardMembers",而且屬性標
         記的名稱 ( <Name> 標記中的值) 會屬於以下其中之一:

	    - DefaultDisplayProperty:物件的單一屬性。

            - DefaultDisplayPropertySet:物件的一個或多個屬性。

            - DefaultKeyPropertySet:物件的一個或多個索引鍵屬性。索引鍵屬性可識別屬性
              值的執行個體,例如工作階段歷程記錄中的項目識別碼。

         例如,下列 XML 會定義 Get-Service Cmdlet 所傳回之服務 
         (System.ServiceProcess.ServiceController 物件) 的預設顯示。這個 XML 會定義一個名
         稱為 "PsStandardMembers" 的成員集,其中包含有 Status、Name 和 DisplayName 屬性
         的預設屬性集。

             <Type>
                <Name>System.ServiceProcess.ServiceController</Name>
                <Members>
                   <MemberSet>
                       <Name>PSStandardMembers</Name>
                       <Members>
                           <PropertySet>
                             <Name>DefaultDisplayPropertySet</Name>
                             <ReferencedProperties>
                                <Name>Status</Name>
                                <Name>Name</Name>
                                <Name>DisplayName</Name>
                             </ReferencedProperties>
                           </PropertySet>
                       </Members>
                   </MemberSet>
                </Members>
             </Type>


   
      <Method>:參考基礎物件的原生方法。

      <Methods>:物件方法的集合。

      <NoteProperty>:定義有靜態值的屬性。

         <NoteProperty> 標記必須有一對指定新屬性之名稱的 <Name> 標記,以及一對指定屬
         性之值的 <Value> 標記。
         例如,下列 XML 會建立目錄 (System.IO.DirectoryInfo 物件) 的 Status 屬性。Status 
         屬性的值一定是 "Success"。

             <Type>
                 <Name>System.IO.DirectoryInfo</Name>
                 <Members>
                     <NoteProperty>
                        <Name>Status</Name>
	                <Value>Success</Value>
                     </NoteProperty>
                 </Members>
             </Type>


      <ParameterizedProperty>:接受引數和傳回值的屬性。

      <Properties>:物件屬性的集合。

      <Property>:基底物件的屬性。

      <PropertySet>:定義物件屬性的集合。

         <PropertySet> 標記必須有一對指定屬性集之名稱的 <Name> 標記,以及一對指定屬性
         的 <ReferencedProperty> 標記。屬性的名稱是括在 <Name> 標記內。
         在 Types.ps1xml 中,<PropertySet> 標記是用來為物件的預設顯示定義屬性集。您可
         以依照 <MemberSet> 標記的 <Name> 標記中的 "PsStandardMembers" 值來識別預設
         顯示。
         例如,下列 XML 會建立目錄 (System.IO.DirectoryInfo 物件) 的 Status 屬性。Status 
         屬性的值一定是 "Success"。

             <Type>
                 <Name>System.ServiceProcess.ServiceController</Name>
                 <Members>
                     <MemberSet>
                         <Name>PSStandardMembers</Name>
                         <Members>
                             <PropertySet>
                                 <Name>DefaultDisplayPropertySet</Name>
                                 <ReferencedProperties>
                                     <Name>Status</Name
                                     <Name>Name</Name>
                                     <Name>DisplayName</Name>
                                 </ReferencedProperties>
                             </PropertySet>
                         <Members>
                     <MemberSet>
                 <Members>
             <Type>


     <ScriptMethod>:定義值為指令碼輸出的方法。

         <ScriptMethod> 標記必須有一組 <Name> 標記 (用於指定新方法的名稱) 與一
         組 <Script> 標記 (用於含括會傳回方法結果的指令碼區塊)。
         例如,管理物件 (System.System.Management.ManagementObject) 的 
         ConvertToDateTime 和 ConvertFromDateTime 方法是使用 
         System.Management.ManagementDateTimeConverter 類別之 ToDateTime 和 
         ToDmtfDateTime 靜態方法的指令碼方法。

              <Type>
                 <Name>System.Management.ManagementObject</Name>
                 <Members>
                     <ScriptMethod>
                         <Name>ConvertToDateTime</Name>
                         <Script>
                             [System.Management.ManagementDateTimeConverter]::ToDateTime($args[0])
                         </Script>
                     </ScriptMethod>
                     <ScriptMethod>
                         <Name>ConvertFromDateTime</Name>
                         <Script>
                             [System.Management.ManagementDateTimeConverter]::ToDmtfDateTime($args[0])
                         </Script>
                     </ScriptMethod>
                 </Members>
             </Type>


      <ScriptProperty>:定義值為指令碼輸出的屬性。

         <ScriptProperty> 標記必須有一對指定新屬性之名稱的 <Name> 標記,以及一對括住傳
         回屬性值之指令碼區塊的 <GetScriptBlock> 標記。
         
	 例如,檔案 (System.IO.FileInfo 物件) 的 VersionInfo 屬性是使用 
         System.Diagnostics.FileVersionInfo 物件的 GetVersionInfo 靜態方法之 FullName 
	 屬性所產生的指令碼屬性。

             <Type>
                <Name>System.IO.FileInfo</Name>
                <Members>
                    <ScriptProperty>
                       <Name>VersionInfo</Name>
                       <GetScriptBlock>
                           [System.Diagnostics.FileVersionInfo]::GetVersionInfo($this.FullName)
                       </GetScriptBlock>
                    </ScriptProperty>   
                </Members>
             </Type>


      如需詳細資訊,請參閱 MSDN (Microsoft Developer Network) Library 中的
      <Windows PowerShell 軟體開發套件 (SDK)>(英文),網址為 
      https://go.microsoft.com/fwlink/?LinkId=144538。


  Update-TypeData
    
      若要將您的 Types.ps1xml 檔案載入 Windows PowerShell 主控台,請使用 
      Update-TypeData Cmdlet。如果想要讓這個檔案中的型別的優先順序高於內建 
      Types.ps1xml 檔案中的型別,請使用 Update-TypeData 的 PrependData 參數。
      Update-TypeData 只會影響目前的主控台。若要讓所做的變更影響所有以後的主控
      台,請匯出目前的主控台,或將 Update-TypeData 命令新增至 Windows PowerShell 設
      定檔。


  為 Types.ps1xml 檔案加上簽章

      為了保護 Types.ps1xml 檔案的使用者,您可以用數位簽章來為檔案加上簽章。如需詳細
      資訊,請參閱 about_Signing。
    	

請參閱
    about_Signing
    Copy-Item
    Get-Member
    Update-TypeData





目錄