New-CMAccessAccount
New-CMAccessAccount
Adds users or groups to an access account.
構文
Parameter Set: SearchByApplicationName
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -ApplicationName <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByApplication
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -Application <IResultObject> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByApplicationId
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -ApplicationId <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByBootImage
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -BootImage <IResultObject> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByBootImageId
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -BootImageId <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByBootImageName
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -BootImageName <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByDriverPackage
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -DriverPackage <IResultObject> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByDriverPackageId
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -DriverPackageId <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByDriverPackageName
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -DriverPackageName <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSImage
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -OperatingSystemImage <IResultObject> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSImageId
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -OperatingSystemImageId <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSImageName
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -OperatingSystemImageName <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSInstaller
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -OperatingSystemInstaller <IResultObject> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSInstallerId
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -OperatingSystemInstallerId <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSInstallerName
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -OperatingSystemInstallerName <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByPackage
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -Package <IResultObject> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByPackageId
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -PackageId <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByPackageName
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -PackageName <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchBySoftwareUpdateDeploymentPackage
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -SoftwareUpdateDeploymentPackage <IResultObject> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchBySoftwareUpdateDeploymentPackageId
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -SoftwareUpdateDeploymentPackageId <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchBySoftwareUpdateDeploymentPackageName
New-CMAccessAccount -Access <AccessRight> {Change | FullControl | NoAccess | Read} -AccountType <AccessAccountType> {Administrator | Guest | User | WindowsGroup | WindowsUser} -SoftwareUpdateDeploymentPackageName <String> [-UserName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The New-CMAccessAccount cmdlet adds users or groups to an access account.
An access account is a list of users or groups that can access an established service or application that is located on a distribution point. For example, members in the Software Update Point Connection access account can access two services to manage software updates: Windows Server Update Services (WSUS) and WSUS Synchronization Manager.
パラメーター
-Access<AccessRight>
Specifies the access rights that are associated with an access account. Valid values are: No Access, Read, Change, and Full Control.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-AccountType<AccessAccountType>
Specifies an account type. Valid values are: Guest, User, WindowsGroup, and WindowsUser.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Application<IResultObject>
Specifies a deployed application object. You can get an application object by using the Get-CMApplication cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ApplicationId<String>
Specifies the ID of an application.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-ApplicationName<String>
Specifies the name of an application.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-BootImage<IResultObject>
Specifies a boot image object. A boot image object contains the Windows files that are required to prepare a computer for the installation of an operating system. You can get a boot image object by using the Get-CMBootImage cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-BootImageId<String>
Specifies the ID of a boot image.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-BootImageName<String>
Specifies the name of a boot image.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DriverPackage<IResultObject>
Specifies a driver package object. A driver package object specifies a group of hardware drivers that are required to install an operating system. You can get a driver package object by using the Get-CMDriverPackage cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DriverPackageId<String>
Specifies the ID of a driver package.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DriverPackageName<String>
Specifies the name of a driver package.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-OperatingSystemImage<IResultObject>
Specifies an operating system image object. An operating system image object contains the Windows files that compose a complete Windows installation. You can get an operating system image object by using the Get-CMOperatingSystemImage cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-OperatingSystemImageId<String>
Specifies the ID of an operating system image.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-OperatingSystemImageName<String>
Specifies the name of an operating system image.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-OperatingSystemInstaller<IResultObject>
Specifies an operating system installer object. An operating system installer object contains the Windows files that are required to prepare a computer for the installation of an operating system. To obtain an operating system installer object, use the Get-CMOperatingSystemInstaller cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-OperatingSystemInstallerId<String>
Specifies the ID of an operating system installer.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-OperatingSystemInstallerName<String>
Specifies the name of an operating system installer.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Package<IResultObject>
Specifies a deployed software script or program object. You can get a package by using the Get-CMPackage cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PackageId<String>
Specifies the ID of a deployed software script or program.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-PackageName<String>
Specifies the name of a deployed software script or program.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SoftwareUpdateDeploymentPackage<IResultObject>
Specifies a deployed software update object. You can get a software update deployment object by using the Get-CMSoftwareUpdateDeploymentPackage cmdlet.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SoftwareUpdateDeploymentPackageId<String>
Specifies the ID of a deployed software update.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-SoftwareUpdateDeploymentPackageName<String>
Specifies the name of a deployed software update.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-UserName<String>
Specifies a Windows user account name in domain\user format.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
Example 1: Modify access to an application by using the application ID
In this example, the first command gets an application ID and stores it in the variable $ID.
The second command gets the application that is identified by the variable $ID and adds a user to the access account. The new user's permissions are set to FullControl.
PS C:\> $ID = Get-CMAccessAccount -ApplicationID "12994680"
PS C:\> New-CMAccessAccount -ApplicationID $ID -Type WindowsUser Username "CONTOSO\EDaugherty" -Access "FullControl"