次の方法で共有

製品の用語とブランド化のガイドライン

製品について記述するときは、適切な製品名と用語を使用することが重要です。 このガイドでは、PowerShell に関連する製品名と用語を定義します。 特定の単語またはユース ケースの大文字と小文字に注意してください。

PowerShell (集合名)

PowerShell を使用して、スクリプト言語と対話型シェルを記述します。

PowerShell (製品名)

.NET Framework ではなく、.NET (コア) 上に構築された PowerShell のクロスプラットフォーム バージョン。 PowerShell は、Windows、Linux、macOS にインストールできます。

PowerShell Core (製品は非推奨)

.NET Core 上に構築された PowerShell v6 に使用される名前。 この名前は使用しないでください。

Windows PowerShell (製品名)

Windows に付属する PowerShell のバージョン。これには完全な .NET Framework が必要です。

ガイドライン

  • 最初に言及する - "Windows PowerShell" を使用する

  • 以降のメンション - ユース ケースで "Windows PowerShell" をより具体的にする必要がある場合を除き、"PowerShell" を使用します。

    PowerShell では、Invoke-WebRequest コマンドレットは BasicHtmlWebResponseObject を返します。

    Windows PowerShell では、Invoke-WebRequest コマンドレットは HtmlWebResponseObject を返します

PowerShell モジュール

PowerShell モジュールは、特定の製品またはサービスを管理するための PowerShell コマンドレットを含むアドオンです。

例えば次が挙げられます。

  • Azure PowerShell
  • Az.Accounts モジュール
  • Windows 管理モジュール
  • Hyper-V モジュール
  • Microsoft Graph PowerShell SDK
  • Exchange PowerShell

ガイドライン

  • PowerShell モジュールを参照するときは、常に集合名またはより具体的なモジュール名を使用します
  • モジュールを "PowerShell" と参照しないでください

Azure PowerShell (集合名)

Azure の管理に使用される PowerShell モジュールを含むブランド化された製品グループ。

Azure PowerShell 製品には複数のバージョンがあります。 各製品には、複数の名前付きモジュールが含まれています。

ガイドライン

  • 製品の集合名として "Azure PowerShell" を使用する
  • 常に集合名を使用します。単なる "PowerShell" は使用しないでください
  • 特定のバージョンを参照する場合は、より具体的な製品名を使用します

Az PowerShell (製品名)

PowerShell を使用して Azure リソースを管理するために現在サポートされているモジュールのコレクション。

AzureRM PowerShell (製品名)

Azure リソースを管理するために Azure Resource Manager (ARM) モデルを使用する前の世代のモジュール。 この製品は非推奨となり、保守もサポートもされなくなり、推奨されません。

Azure Service Management PowerShell (製品名)

Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのモジュールの最も古いコレクション。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。

これらの製品は Azure リソースの管理に使用されますが、Azure PowerShell の集合製品の一部ではありません。 "Azure PowerShell" の集合名を使用して記述しないでください。

  • Azure Information Protection PowerShell
  • Azure Deployment Manager の PowerShell
  • Azure エラスティック データベース ジョブ PowerShell
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • Microsoft Graph PowerShell SDK
  • Microsoft Entra PowerShell

ガイドライン

  • 製品の完全で適切な名前または特定の PowerShell モジュール名を常に使用する

Visual Studio Code (VS Code)

これは、Microsoft の無料のオープン ソース エディターです。

ガイドライン

  • 最初の言及ではフルネームを使う
  • 以降は「VS Code」と呼んでください
  • "VSCode" を使用しない

Visual Studio Code 用 PowerShell 拡張機能

拡張機能により、VS Code が PowerShell 用の優先 IDE に変換されます。

ガイドライン

  • 最初の言及ではフルネームを使う
  • 以降の言及では "PowerShell 拡張機能" を使用できます