New-CMAccessAccount

Agrega usuarios o grupos a una cuenta de acceso.

Syntax

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

Description

El cmdlet New-CMAccessAccount agrega usuarios o grupos a una cuenta de acceso.

Una cuenta de acceso es una lista de usuarios o grupos que pueden tener acceso a un servicio o aplicación establecido que se encuentra en un punto de distribución. Por ejemplo, los miembros de la cuenta de acceso a la conexión de punto de actualización de software pueden acceder a dos servicios para administrar actualizaciones de software: Windows Server Update Services (WSUS) y administrador de sincronización de WSUS.

Nota

Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1: Modificar el acceso a una aplicación mediante el identificador de aplicación

PS XYZ:\> $ID = Get-CMAccessAccount -ApplicationID "12994680"
PS XYZ:\> New-CMAccessAccount -ApplicationID $ID -Type WindowsUser Username "CONTOSO\EDaugherty" -Access "FullControl"

El primer comando obtiene un identificador de aplicación y, a continuación, lo almacena en la $ID variable.

El segundo comando obtiene la aplicación identificada por $ID y agrega un usuario a la cuenta de acceso. Los permisos del nuevo usuario se establecen en FullControl.

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-Access

Especifica los derechos de acceso asociados a una cuenta de acceso. Los valores válidos son: Sin Access, Read, Change y Full Control.

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

-AccountType

Especifica un tipo de cuenta. Los valores válidos son: Guest, User, WindowsGroup y WindowsUser.

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

-ApplicationId

Especifica el identificador de una aplicación.

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

-ApplicationName

Especifica el nombre de una aplicación.

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

-BootImageId

Especifica el identificador de una imagen de arranque.

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

-BootImageName

Especifica el nombre de una imagen de arranque.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-DriverPackageId

Especifica el identificador de un paquete de controladores.

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

-DriverPackageName

Especifica el nombre de un paquete de controladores.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifica la entrada de este cmdlet. Puede usar este parámetro o canalizar la entrada a este cmdlet.

Type:IResultObject
Aliases:Application, BootImage, DriverPackage, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-OperatingSystemImageId

Especifica el identificador de una imagen del sistema operativo.

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

-OperatingSystemImageName

Especifica el nombre de una imagen del sistema operativo.

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

-OperatingSystemInstallerId

Especifica el identificador de un instalador de sistema operativo.

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

-OperatingSystemInstallerName

Especifica el nombre de un instalador del sistema operativo.

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

-PackageId

Especifica el identificador de un programa o script de software implementado.

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

-PackageName

Especifica el nombre de un script o programa de software implementado.

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

-SoftwareUpdateDeploymentPackageId

Especifica el identificador de una actualización de software implementada.

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

-SoftwareUpdateDeploymentPackageName

Especifica el nombre de una actualización de software implementada.

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

-UserName

Especifica un nombre Windows cuenta de usuario en formato dominio\usuario.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject