Set-CMAccessAccount

アクセス アカウントのプロパティを変更します。

構文

Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   [-InputObject] <IResultObject>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -ApplicationId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -ApplicationName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -BootImageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -BootImageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -DriverPackageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -DriverPackageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemImageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemImageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemInstallerId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -OperatingSystemInstallerName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -PackageId <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   -PackageName <String>
   [-PassThru]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   [-PassThru]
   -SoftwareUpdateDeploymentPackageId <String>
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAccessAccount
   -Access <AccessRight>
   -AccountType <AccessAccountType>
   [-PassThru]
   -SoftwareUpdateDeploymentPackageName <String>
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-CMAccessAccount コマンドレットは、アクセス アカウントのプロパティを変更します。 アクセス アカウントにユーザーまたはグループを追加し、アクセス許可を持つオブジェクトに対するアクセス許可のレベルを変更できます。

アクセス アカウントは、配布ポイント上にある確立されたサービスまたはアプリケーションにアクセスできるユーザーまたはグループのリストです。 たとえば、ソフトウェア更新ポイント接続アクセス アカウントのメンバーは、Windows Server Update Services (WSUS) と WSUS 同期マネージャーの 2 つのサービスにアクセスしてソフトウェア更新プログラムを管理できます。

注意

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

例 1: パッケージ名を使用してパッケージへのアクセスを変更する

PS XYZ:\> $Name = Get-CMAccessAccount -PackageName "Configuration Manager Client Package"
PS XYZ:\> Set-CMAccessAccount -PackageName $Name -Type User -UserName "CONTOSO\PFuller" -Access Read -Confirm

最初のコマンドはパッケージ名を取得し、パッケージ名を変数$Nameします。

2 番目のコマンドは、ユーザーのアクセス許可をパッケージに対して読み取りに設定します。 コマンドで実行する前に、アクションを確認する必要があります。

パラメーター

-Access

アクセス アカウントに関連付けられているアクセス権を指定します。 有効な値は、アクセスなし、読み取り、変更、およびフル コントロールです。

Type:AccessRight
Accepted values:NoAccess, Read, Change, FullControl
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AccountType

アカウントの種類を指定します。 有効な値は、ゲスト、ユーザー、WindowsGroup、および WindowsUser です。

Type:AccessAccountType
Accepted values:User, Guest, Administrator, WindowsUser, WindowsGroup
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ApplicationId

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

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

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

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

ブート イメージの ID を指定します。

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

ブート イメージの名前を指定します。

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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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
-DriverPackageId

ドライバー パッケージの ID を指定します。

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

ドライバー パッケージの名前を指定します。

Type:String
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
-InputObject
Type:IResultObject
Aliases:DriverPackage, Application, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage, BootImage
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-OperatingSystemImageId

オペレーティング システム イメージの ID を指定します。

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

オペレーティング システム イメージの名前を指定します。

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

オペレーティング システム インストーラーの ID を指定します。

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

オペレーティング システム インストーラーの名前を指定します。

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

展開されたソフトウェア スクリプトまたはプログラムの ID を指定します。

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

展開されたソフトウェア スクリプトまたはプログラムの名前を指定します。

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

このパラメーターを追加して、作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

展開されたソフトウェア更新プログラムの ID を指定します。

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

展開されたソフトウェア更新プログラムの名前を指定します。

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

ドメイン\ユーザー Windows形式のユーザー アカウント名を指定します。

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

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object