Set-SCOMRunAsDistribution

Módulo:

OperationsManager

Establece la directiva de distribución de una cuenta de ejecución para Operations Manager.

Syntax

Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   [-LessSecure]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   [-MoreSecure]
   [-SecureDistribution <Object[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMRunAsDistribution
   [-RunAsAccount] <SecureData>
   -Security <String>
   [-SecureDistribution <Object[]>]
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-SCOMRunAsDistribution establece la directiva de distribución de una cuenta de ejecución para System Center Operations Manager. Las directivas de distribución determinan qué equipos reciben una credencial para una cuenta de ejecución. De forma predeterminada, las nuevas cuentas tienen la distribución más segura sin sistemas aprobados.

Ejemplos

Ejemplo 1: Especificar una distribución menos segura

PS C:\>Get-SCOMRunAsAccount -Name "Contoso\LowPriv" | Set-SCOMRunAsDistribution -LessSecure

Este comando establece la cuenta Contoso\LowPriv para una distribución menos segura, de modo que Operations Manager distribuya automáticamente la credencial a todos los equipos administrados. El comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta especificada y la pasa al cmdlet Set-SCOMRunAsDistribution mediante el operador de canalización. El comando especifica el parámetro LessSecure .

Ejemplo 2: Especificar una distribución más segura sin sistemas aprobados

PS C:\>Get-SCOMRunAsAccount -Name "Contoso\LowPriv" | Set-SCOMRunAsDistribution -MoreSecure

Este comando establece la cuenta Contoso\LowPriv para una distribución más segura, sin sistemas aprobados. El comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta especificada y la pasa al cmdlet Set-SCOMRunAsDistribution mediante el operador de canalización. El comando especifica el parámetro MoreSecure .

Ejemplo 3: Especificar una distribución más segura para una colección

PS C:\>$Distribution = (Get-SCOMAgent -Name "*.contoso.com") + (Get-SCOMManagementServer) + (Get-SCOMResourcePool -DisplayName "Contoso Monitoring Pool")
PS C:\> Get-SCOMRunAsAccount "Contoso\LowPriv" | Set-SCOMRunAsDistribution -MoreSecure -SecureDistribution $Distribution

En este ejemplo se establece la cuenta Contoso\LowPriv para una distribución más segura en una colección de grupos, agentes y servidores, de modo que solo los grupos, agentes y servidores especificados obtengan la distribución.

El primer comando obtiene los grupos, agentes y servidores para recibir una distribución más segura y los almacena en la variable $Distribution .

El segundo comando obtiene grupos, agentes y servidores que tienen una distribución menos segura y los pasa al cmdlet Set-SCOMRunAsDistribution mediante el operador de canalización. Ese cmdlet les asigna una distribución más segura.

Ejemplo 4: Especificar una distribución menos segura para una nueva cuenta de ejecución

PS C:\>Add-SCOMRunAsAccount -Windows -Name "NewAccount" -Credential (Get-Credential) | Set-SCOMRunAsDistribution -MoreSecure -SecureDistribution (Get-SCOMAgent)

Este comando crea una cuenta de ejecución para Windows y la aprueba para su distribución a todos los agentes. El comando usa el cmdlet Add-SCOMRunAsAccount para agregar la cuenta NewAccount con la credencial que crea el cmdlet Get-Credential . A continuación, pasa el resultado al cmdlet Set-SCOMRunAsDistribution mediante el operador de canalización.

Ejemplo 5: Copia de una directiva de distribución más segura en otra cuenta

PS C:\>$MonitoringAcct = Get-SCOMRunAsAccount "Contoso\Monitoring"
PS C:\> Get-SCOMRunAsAccount "Contoso\Administrator" | Get-SCOMRunAsDistribution | Set-SCOMRunAsDistribution -RunAsAccount $MonitoringAccount

En este ejemplo se copia la directiva de distribución segura de la cuenta Contoso\Administrator en la cuenta Contoso\Monitoring.

El primer comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta Contoso\Monitoring y la almacena en la variable $MonitoringAcct.

El segundo comando usa el cmdlet Get-SCOMRunAsAccount para obtener la cuenta Contoso\Administrator y la pasa al cmdlet Get-SCOMRunAsDistribution mediante el operador de canalización. El comando pasa el resultado al cmdlet Set-SCOMRunAsDistribution para copiar el resultado en la cuenta Contoso\Monitoring.

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres netBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe iniciarse en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Credential

Especifica la cuenta de usuario con la que se ejecuta la conexión del grupo de administración. Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , para este parámetro. Para obtener más información sobre los objetos de credenciales, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

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

-LessSecure

Indica que Operations Manager distribuye automáticamente la credencial a todos los equipos administrados.

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

-MoreSecure

Indica que Operations Manager distribuye la credencial solo a los sistemas que especifica el parámetro SecureDistribution .

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

-PassThru

Indica que el cmdlet crea o modifica un objeto que un comando puede usar en la canalización. De forma predeterminada, este cmdlet no genera ningún resultado.

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

-RunAsAccount

Especifica una matriz de objetos SecureData que representan cuentas de ejecución. Para obtener un objeto SecureData , use el cmdlet Get-SCOMRunAsAccount . Esta cuenta no puede formar parte de un perfil de ejecución.

Type:	SecureData
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Especifica una matriz de objetos Connection . Para obtener objetos Connection , use el cmdlet Get-SCOMManagementGroupConnection .

Si no se especifica este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential . Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecureDistribution

Especifica una matriz de objetos que representan sistemas que el cmdlet autoriza para su distribución.

Esta lista de parámetros solo puede contener los siguientes tipos de elementos:

• Agentes. Objetos que devuelve el cmdlet Get-SCOMAgent . El cmdlet autoriza esta cuenta al agente para su distribución.
• Servidores de administración. Objetos que devuelve el cmdlet Get-SCOMManagementServer . El cmdlet autoriza esta cuenta al agente para su distribución.
• Grupos. Objetos que devuelve el cmdlet Get-SCOMResourcePool . El cmdlet autoriza esta cuenta al agente para su distribución.
• Instancias del servicio de mantenimiento. Objetos que devuelve el cmdlet Get-SCOMClassInstance y que tienen un tipo administrado de HealthService. El cmdlet autoriza este servicio de mantenimiento al agente para su distribución.

Pasar la salida del cmdlet Get-SCOMRunAsDistribution como entrada a Set-SCOMRunAsDistribution mediante el operador de canalización rellena automáticamente este parámetro.

Type:	Object[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Security

Especifica el nivel de seguridad. Los valores permitidos para este parámetro son los siguientes:

• MoreSecure
• LessSecure

Pasar la salida del cmdlet Get-SCOMRunAsDistribution como entrada a Set-SCOMRunAsDistribution mediante el operador de canalización rellena automáticamente este parámetro.

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

-WhatIf

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

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

Vínculos relacionados

• Get-SCOMAgent
• Get-SCOMClassInstance
• Get-SCOMManagementServer
• Get-SCOMResourcePool
• Get-SCOMRunAsAccount
• Get-SCOMRunAsDistribution