Approve-CMApprovalRequest

アプリケーションのインストールを許可する要求を承認します。

構文

Approve-CMApprovalRequest
       [-Comment <String>]
       -InputObject <IResultObject>
       [-InstallActionBehavior <ActionBehavior>]
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Approve-CMApprovalRequest
       -ApplicationName <String[]>
       [-Comment <String>]
       [-InstallActionBehavior <ActionBehavior>]
       -User <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Approve-CMApprovalRequest
       [-Comment <String>]
       -Id <String[]>
       [-InstallActionBehavior <ActionBehavior>]
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Approve-CMApprovalRequest
       [-Comment <String>]
       [-InstallActionBehavior <ActionBehavior>]
       -RequestGuid <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Approve-CMApprovalRequest コマンドレットは、アプリケーションのインストール要求をユーザーから承認します。 承認要求は、アプリケーション名、アプリケーション ID、またはユーザーによって指定できます。 Get-CMApprovalRequest コマンドレットを使用して、承認要求を表示することもできます。

注:

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

例 1: 特定のアプリケーションの要求を承認する

PS XYZ:\>Approve-CMApprovalRequest -Id "ScopeId_2A11048C-917A-4C11-9E77-7DCC402F30EC/Application_426dfca1-0cc0-4aa3-85f8-3cd1b184d494/1"

このコマンドは、ID で指定されたアプリケーションをインストールするためのユーザーからの要求を承認します。

例 2: 特定のユーザーの要求を承認する

PS XYZ:\>Approve-CMApprovalRequest -Application "Test" -User "tsqa\davidchew" -Comment "Request approved."

このコマンドは、指定したユーザーの Test という名前のアプリケーションに対する要求を承認します。 コマンドにはコメントが含まれています。

例 3: 変数を使用して要求を承認する

PS XYZ:\> $Approval = Get-CMApprovalRequest -Id "ScopeId_2A11048C-917A-4C11-9E77-7DCC402F30EC/Application_d047e945-d6af-46f4-910f-ed36c880ae06/1"
PS XYZ:\> Approve-CMApprovalRequest -InputObject $Approval -Comment "Request approved."

最初のコマンドは、指定されたアプリケーション ID の承認要求を取得し、変数 $Approvalに格納します。

2 番目のコマンドは、 $Approvalに格納されている要求を受け入れます。 コマンドにはコメントが含まれています。

パラメーター

-ApplicationName

アプリケーションの名前の配列を指定します。

型:String[]
Aliases:Application, Name
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Comment

要求の承認に関するコメントを指定します。

型:String
Aliases:Comments
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

DisableWildcardHandling は、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせないでください。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

ForceWildcardHandling ではワイルドカード文字が処理され、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせないでください。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

アプリケーションの ID の配列を指定します。

型:String[]
Aliases:CIUniqueId
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

承認要求オブジェクトを指定します。 承認要求オブジェクトを取得するには、 Get-CMApprovalRequest コマンドレットを 使用します。

型:IResultObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-InstallActionBehavior

アプリケーションをインストールするタイミングを指定します 。すぐにインストールするか、営業時間外にインストールするかを指定します。

型:ActionBehavior
指定可能な値:InstallNow, InstallNonBusinessHours
配置:Named
規定値:InstallNow
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RequestGuid

要求 ID を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-User

承認要求を送信したユーザーの名前を指定します。 domain\user という形式を使用します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object