New-CMScript

  • リファレンス
モジュール:
ConfigurationManager

Configuration Manager で PowerShell スクリプトを作成します。

構文

New-CMScript
   [-Fast]
   -ScriptFile <String>
   -ScriptName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMScript
   [-Fast]
   -ScriptName <String>
   -ScriptText <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットを使用して、新しい PowerShell スクリプトを作成します。 これらのスクリプトは、Configuration Manager で統合および管理されます。

詳細については、「Configuration Manager コンソールから PowerShell スクリプトを作成 して実行する」を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: テキストを含むスクリプトを作成する

この例では、CMScript という名前の新しいスクリプト を作成します。 スクリプトのテキストを指定します。

New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'

例 2: ファイルからスクリプトを作成する

この例では、ImportScript という名前の新しい スクリプトを作成します。 ネットワーク共有上の既存のファイルからスクリプトをインポートします。

New-CMScript -ScriptName "ImportScript" -ScriptFile "\\abc\importedscript.ps1" -Fast

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Fast

遅延プロパティを自動的に更新しない場合は、このパラメーターを追加します。 遅延プロパティには、取得に比較的非効率な値が含まれます。 これらのプロパティを取得すると、追加のネットワーク トラフィックが発生し、コマンドレットのパフォーマンスが低下する可能性があります。

このパラメーターを使用しない場合、コマンドレットは警告を表示します。 この警告を無効にするには、 を設定します $CMPSSuppressFastNotUsedCheck = $true 。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScriptFile

PowerShell スクリプト ファイル () へのパスを指定します .ps1 。 ファイルのテキストは、Configuration Manager のスクリプトに使用されます。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScriptName

作成するスクリプトの名前を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScriptText

作成するスクリプトのテキストを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

なし

出力

System.Object