Compartilhar via

Set-CMActiveDirectoryForest

  • Referência
Módulo:
ConfigurationManager

Altera as propriedades da floresta do Active Directory no Configuration Manager.

Sintaxe

Set-CMActiveDirectoryForest
   [-AddPublishingSite <IResultObject[]>]
   [-Description <String>]
   [-EnableDiscovery <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-Password <SecureString>]
   [-PublishingPath <String>]
   [-RemovePublishingSite <IResultObject[]>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMActiveDirectoryForest
   [-AddPublishingSite <IResultObject[]>]
   [-Description <String>]
   [-EnableDiscovery <Boolean>]
   -ForestFqdn <String>
   [-PassThru]
   [-Password <SecureString>]
   [-PublishingPath <String>]
   [-RemovePublishingSite <IResultObject[]>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMActiveDirectoryForest
   [-AddPublishingSite <IResultObject[]>]
   [-Description <String>]
   [-EnableDiscovery <Boolean>]
   -Id <UInt32>
   [-PassThru]
   [-Password <SecureString>]
   [-PublishingPath <String>]
   [-RemovePublishingSite <IResultObject[]>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMActiveDirectoryForest altera os valores de um objeto de floresta do Active Directory no Configuration Manager. Pode editar a descrição, ativar ou desativar a deteção e especificar um nome de domínio completamente qualificado (FQDN) e o caminho de publicação. Pode especificar um objeto de floresta do Active Directory por ID ou FQDN ou pode fornecer o próprio objeto de floresta do Active Directory.

A Deteção de Florestas do Active Directory requer uma conta global para detetar ou publicar em florestas não fidedignas.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Alterar a descrição de uma floresta do Active Directory

PS XYZ:\> Set-CMActiveDirectoryForest -Id "16777217" -Description "AD Forest 01"

Este comando altera a descrição de uma floresta do Active Directory que tem o ID 16777217 para AD Forest 01.

Parâmetros

-AddPublishingSite

Tipo:IResultObject[]
Aliases:AddPublishingSites
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para um objeto de floresta do Active Directory.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableDiscovery

Especifica se pretende detetar sites e sub-redes do Active Directory. Tem de configurar um método de Deteção de Floresta do Active Directory antes de utilizar este parâmetro. O valor padrão é $False.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForestFqdn

Especifica o FQDN de um objeto do Configuration Manager.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica uma matriz de IDs de objetos do Configuration Manager. Pode encontrar o valor do identificador na propriedade ForestID de uma floresta do Active Directory.

Tipo:UInt32
Aliases:ForestId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto de floresta do Active Directory no Configuration Manager.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Password

{{ Descrição da Palavra-passe de Preenchimento }}

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublishingPath

Especifica um ou mais sites do Configuration Manager que publicam informações do site numa floresta do Active Directory. Pode utilizar uma lista separada por vírgulas entre aspas para especificar mais do que um site.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemovePublishingSite

Tipo:IResultObject[]
Aliases:RemovePublishingSites
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserName

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject